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1.  INTRODUCTION 


POLAR  is  a  set  of  computer  programs  designed  to  predict  the 
electrical  interactions  between  the  natural  environment  and  a  large 
spacecraft  in  polar  earth  orbit.  POLAR  consists  of  many  complex 
physical  models  which  have  been  converted  to  algorithms  and  connected 
by  an  executive  structure.  Since  there  are  a  wide  variety  of 
spacecraft  and  environments,  POLAR  has  been  written  with  maximum 
flexibility  and  applicability  in  mind.  However,  to  allow  for  when  a 
model  may  prove  inadequate,  POLAR  has  been  designed  with  a  high  degree 
of  modularity  to  enable  changes  in  the  physical  models  and  algorithms 
to  be  made  quickly  and  reliably.  The  documentation  is  also  designed 
modularly  so  that  code  modifications  can  be  documented  immediately. 

Thus  this  manual  is  intended  to  be  a  living  document,  accurately 
reflecting  the  most  current  status  of  the  POLAR  code.  This  modularity 
does  make  for  difficult  reading,  but  we  feel  that  the  total  information 
content  is  enhanced  and  that  it  is  a  valuable  compromise.  Since  the 
models  in  POLAR  are  subject  to  change  and  replacement,  it  is  important 
to  have  matched  editions  of  the  manual  and  the  computer  code.  The 
edition  date  for  this  manual  is  July  1984,  and  it  describes  the  edition 
of  POLAR  delivered  to  AFGL  in  July  1984. 

1.10  CODE  STRUCTURE 

POLAR  is  written  in  FORTRAN  in  accordance  with  top  down 
structural  programming  principles.  It  consists  of  four  main  programs 
and  one  attending  utility  program.  Program  one,  called  VEHICL,  handles 
object  definition.  Program  two,  called  ORIENT,  is  used  to  reorient  an 
object  and  the  grid.  Program  three,  called  NTERAK,  actually  calculates 
the  spacecraft-plasma  interaction  and  most  of  the  physical  models  are 
contained  in  NTERAK.  The  fourth  program  is  called  SHONTL,  and  it 
controls  plotting  and  information  retrieval.  The  fifth  program  or 
utility,  PLOTREAD,  translates  the  machine  independent  output  of  SHONTL 
to  local  plot  commands. 


1.20  DOCUMENTATION 


This  document,  as  its  code,  is  structured  heirarchically.  The 
description  of  POLAR  goes  from  basic  physics,  to  physical  models,  to 
algorithms,  to  coding  structure,  and  finally,  to  operating 
constructions.  As  of  this  date  (August  1983)  many  of  the  sections  are 
missing  as  is  much  of  the  coding.  As  more  coding  comes  on  line  it  will 
be  reflected  in  additions  to  this  document. 
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3.  PHYSICAL  MODELS  EMPLOYED  IN  THE  POLAR  CODE 


The  POLAR  code  makes  various  assumptions  which  enable  it  to 
perform  three-dimensional  charge  calculations  in  relatively  short 
Debye  length  plasmas.  In  this  section  we  examine  the  component 
physical  models  and  discuss  their  validity.  While  each  is  addressed 
separately,  the  code  achieves  a  self-consistent  solution  by  various 
levels  of  iteration.  These  afre  described  more  fully  in  Chapter  4, 
Computational  Techniques.  This  chapter  provides  a  so-called  executive 
summary  of  the  models  as  if  the  numerics  were  arbitrarily  accurate. 
Numerical  techniques  are  discussed  in  greater  detail  in  Chapter  4. 

One  major,  overriding  assumption  should  be  identified  before  the 
component  by  component  description,  which  is  that  all  time  dependence 
on  the  scale  of  particle  dynamics  is  ignored.  This  means  that 
particles  see  spatially  dependent  but  time  independent  fields  for  the 
period  they  are  near  the  orbiting  vehicle.  As  such,  all  plasma 
oscillations,  including  electron  and  ion  modes  are  precluded.  Thus, 
oscillations  in  the  wake  or  at  leading  edges  will  not  be  predicted  by 
the  POLAR  code. 

3.10  THE  POLAR  PLASMA  ENVIRONMENT 

POLAR  can  model  a  wide  variety  of  plasma  environments  from 
reasonable  combinations  of  the  following  populations: 

Ions; 

Cool  Maxwellian  ions  (input  AMU). 

Cool  Maxwellian  protons. 

Both  the  protons  and  ions  are  assumed  to  be  isotropic  in  the  plasma 
frame.  The  relative  densities  are  controlled  by  imputing  the  density 
ratio  with  the  total  constrained  to  equal  the  ambient  electron 
density.  Both  populations  have  temperatures  equal  to  the  temperature 
1  of  the  cool  electrons. 
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Electrons: 

Cool  ambient  Maxwellian,  temperature  1,  density  1. 
Suprathermal,  power  law  distribution  of  energies. 

Hot  Maxwellian,  temperature  2,  density  2. 

Energetic,  Gaussian  distribution  of  energies. 

The  cool  Maxwellian  population  is  considered  isotropic  in  the 
plasma  fVame.  The  other,  more  energetic  populations  may  be  given 
field-aligned  and  loss-cone  distributions. 

Limitation: 

Currently,  many  of  the  options  listed  above  are  not  consistently 
implemented  throughout  POLAR.  Specifically,  all  electron  populations 
are  considered  isotropic,  and  the  proton  population  is  ignored  in  the 
sheath  model  (3.60).  These  restrictions  will  be  removed  in  future 
work . 

3.20  PLASMA  POTENTIALS 


The  other  major  assumption  is  that  the  only  fields  of  major 
importance  are  the  static  electric  fields  obtainable  from  Poisson's 
equation  and  the  earth's  magnetic  field.  The  only  velocity  related 
field  included  is  that  induced  by  V  x  B  on  conducting  surfaces.  The 
frame  of  reference  is  chosen  to  be  the  stationary  plasma,  so  that 
V  x  B  effects  appear  on  the  vehicle  as  boundary  conditions.  The 

"s*  «v 

plasma  at  infinity  is  defined  to  be  at  zero  potential. 

Plasma  potentials  are  obtained  from  Poisson's  equation 
v  2<t>  =  x”2(ni  -  ng) 

2  2 

where  x  is  the  Debye  length  (x  =  e0  kT/Ne  ),  and  the  charge 
density  is  that  of  the  ambient  plasma.  Contributions  from  hot  auroral 
electrons  and  particles  backscattered  from  the  vehicle  are  neglected. 
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3.30  PARTICLE  DENSITIES 


3.3-1 


The  electron  density  is  assumed  to  be  Maxwellian  without  any 
excluded  orbits; 


e*/kT 


where  ng  is  the  unperturbed  cold  component  plasma  density.  The 
absence  8f  excluded  orbits  implies  neglecting  potential  barriers  for 
electrons  in  the  wake.  The  validity  of  this  approximation  has  been 
studied  using  as  an  extreme  case  a  disk  moving  infinitely  fast  with 
respect  to  thermal  ions,  but  very  slowly  with  respect  to  the  electron 
thermal  velocity.  Such  an  object  has  rigorously  no  ion  charge  density 
in  the  wake  and  thus  has  the  maximum  negative  space  charge  physically 
possible.  Solving  Poisson's  equation  for  this  case  gives  the  maximum 
possible  negative  plasma  potential.  The  central  wake  potential  as  a 
function  of  disk  radius  over  Debye  length  is  shown  in  Figure  3.30/1. 

We  see  that  even  for  shuttle  size  objects  that  the  peak  space  charge 
potential  is  less  than  20  kT,  or  about  2  volts.  If  the  surface 
boundary  conditions  are  more  negative  than  this  wake  space  charge 
maximum,  the  potential  in  the  wake  will  be  monotonic  and  no  electron 
orbits  will  be  shadowed.  This  will  clearly  be  the  case  for  any  case 
with  substantial  negative  charging. 

The  ion  density  term  is  determined  using  one  of  two  models, 
depending  upon  the  local  potential.  At  large  distances  from  the 
object,  where  the  potential  is  near  plasma  ground,  that  is 
substantially  less  than  the  ram  energy  of  the  ions,  ion  orbits  are 
assumed  to  be  unperturbed  by  electric  fields.  In  this  presheath 
region,  ion  densities  are  determined  for  both  ions  and  protons,  by  the 
"neutral  ion  model"  described  next.  A  sheath  edge  is  assumed  to 
separate  the  presheath  from  a  sheath  region  wherein  electric  fields 
dominate  thermal  effects.  In  the  sheath  region,  ion  densities  are 
determined  by  sheath  ion  model  (3.32,  3.60). 


l'brlum  filling  of  ambient  Maxwellian  electrons 


It  is  important  to  note  that  the  ion  densities  that  result  from 
the  combined  use  of  the  neutral  ion  and  sheath  ion  models  are  subject 
to  certain  limitations  and  shortcomings. 

There  is  a  low  density  or  Laplace  limit  where  the  sheath  edge  is 

no  longer  sharply  defined  and  electric  fields  extend  far  into  the 

plasma.  In  this  limit,  the  neutral  ion  approximation  would  fail,  and 

thermal  ion  motion  would  be  incorrectly  ignored  inside  the  sheath 

edge.  This  limit  is  characterized  by  a  Debye  screening  length  that  is 

comparable  to,  or  larger  than,  the  object  size.  This  does  not  mean 

that  POLAR  cannot  provide  useful  results  in  the  long  Debye  length 

limit,  since  the  space  charge  coupling  to  the  potentials  is  recuced  by 
_2 

x  .  The  user  should,  however,  understand  that  ion  densities  and 
sheath  ion  currents  (3.60)  can  be  in  error.  There  is  also  a  short 
Debye  length  limitation  that  occurs  when  the  Debye  length  is  very  much 
less  than  a  zone  size  and  object  potentials  are  low.  This  combination 
can  result  in  an  object  to  sheath-edge  distance  that  should  be  less 
than  a  zone,  which  is,  of  course,  impossible  to  model  accurately. 

This  limitation  is  further  discussed  in  Section  4.44,  and  illustrated 
in  an  example  in  Appendix  C-3. 

There  is  one  further  limitation  of  the  ion  density  model  that 
occurs  when  a  sheath  is  significantly  larger  than  an  object.  In  this 
case,  the  ion  densities  outside  the  sheath  will  have  been  determined 
by  the  neutral  ion  model  using  the  object  as  the  only  perturbation  to 
ion  orbits,  where  it  should  have  used  the  sheath  edge  inasmuch  as  a 
sheath  edge  can  be  considered  perfectly  absorbing  (Section  3.60). 

This  problem  is  scheduled  for  resolution,  but  presently  its  effect 
should  be  minimal  as  far  as  object  charging  is  concerned. 


3.31  THE  NEUTRAL  ION  APPROXIMATION 


In  some  regions  of  space  the  electric  fields  may  be  weak,  and 
potentials  less  than  both  the  ion  flow  energy  and  the  ion  thermal 
energy.  Here,  ion  motion  may  be  approximated  by  that  of  a  neutral 
particle  where  only  collisions  with  absorbing  objects  perturb  the  ion 
density.  The  ion  density  in  this  region  is  calculated  taking  fully 
into  account  ion  thermal  velocities  but  ignoring  bending  of 
trajectories  by  electric  or  magnetic  fields.  This  can  be  expressed  by 
the  following  equation: 


^(x,  v)  *  g(x,  )  f iQ( v) 


where  f.(x,  v)  is  the  ion  distribution  function  at  a  point  x  in 
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space  for  a  velocity  v  and  f.  (v)  is  the  unperturbed  velocity 
distribution  function  for  a  drifting  Maxwellian  (the  assumed  condition 
at  an  infinite  distance  from  the  vehicle).  The  function  g(x,  ^  )  has 
value  zero  if  a  ray  starting  from  x  going  in  the  direction  ^  would 
strike  the  vehicle,  it  has  value  1  otherwise.  This  function  takes 
into  account  particles  who  cannot  contribute  to  the  local  charge 
density  because  they  run  into  the  vehicle.  The  charge  density  is 
obtained  by  integration  over  velocities: 


ni(x)  =  y  f(x,v)dv 
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f  g(x,n)  /fi0(v  n)v2dv 
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Since  the  potential  varies  logarithmically  with  density  in  the  quasi¬ 
neutral  region  about  large  objects  in  short  Debye  length  plasmas,  a 
factor  of  2  error  in  this  density  will  lead  to  less  than  one-tenth 
volt  error  in  the  local  potential;  thus  approximation  is  not  expectea 
to  be  a  source  of  any  large  error. 


3.32  SHEATH  ION  DENSITIES 


Section  3.60  discusses  the  POLAR  sheath  model  and  the  sharp 
edged  sheath  concept.  The  derivation  of  ion  densities  from 
trajectories  within  the  sheath  is  explained  in  4.42.5.  What  follows 
here  is  a  brief  outline. 

Given  a  sheath  edge,  currents  from  "infinity"  to  the  sheath  edge 
are  calculated  analytically  using  orbit-limited  theory.  These 
currents  are  assigned  to  a  set  of  "super  particles"  (Reference  3-5) 
that  are  tracked  inwards  from  the  sheath  edge  to  the  vehicle  surface. 
Ion  densities  are  determined  from  the  product  of  the  particle  current 
and  the  time  that  a  particle  spends  in  an  element,  and  by  the  focusing 
of  trajectories. 


3.40  INCIDENT  CURRENTS 


POLAR  models  a  number  of  charged  particle  sources  as  responsible 
for  surface  and  vehicle  charging.  These  are  ambient  ions  and 
electrons,  energetic  electrons,  ion  and  electron  generated  secondary 
electrons,  and  photoelectrons. 

POLAR  is  presently  constructed  to  model  plasma  interactions  with 
a  negatively  charged  vehicle.  Since  the  comments  of  Section  3.30 
concerning  potential  barriers  apply  here  as  we>l,  we  can  assume  the 
ambient  electrons  to  be  repelled  with  no  excluded  orbits  within  the 
hemisphere  of  velocities  impinging  upon  a  surface.  When  these 
conditions  are  met,  the  velocity  space  integrals  over  a  Maxwellian 
distribution  decouple  from  the  surface  potential  and  we  may  write 


Je(V) 


eeV/kT 


For  the  energetic  electron  sources,  the  current  integrals  are  more 
involved.  These  are  discussed  further  in  Section  3.41  and  presented 
in  Sections  4.52.3  -  4.52.5. 

The  ions  are  presently  the  attracted  specie  in  POLAR.  The 
calculation  of  ion  currents  is  discussed  in  Section  3.42. 


3.41 


INCIDENT  ELECTRON  CURRENTS 


A  statistical  study  (Ref.  3-1)  of  high  latitude  precipitating 
electrons  has  shown  that  these  fluxes  can  be  well  represented  by  the 
following  parametric  expression 


-C(E-E0)/«]2 

♦  (E)  -  AE"°  +  Cn  - L-r*-  e'E/kT  +  E  Be  (3.41-A) 

(kT)J/2 


These  are  the  power  law,  hot  Maxwellian  and  Gaussian 

-1/2 

distributions  mentioned  in  Section  3.10,  where  C  =  (2  m  ) 

-3/2  e 

u  ,  and  A,  a,  n,  T,  B,  EQ  and  s  are  parameters  determined  by 

the  particular  shape  of  a  spectrum.  Here,$(E)  has  units  of 
2 

#/m  .  s  ,  str  ,  keV.  To  apply  these  distributions  to  the  charging 

of  a  surface,  it  is  necessary  to  formulate  the  distribution  function, 
f,  at  the  surface.  We  start  by  disecting  Eqs.  (3.41-A).  Equation 
(3.41-A)  appears  to  assume  a  zero  space  potential  because  a  factor  of 
E  (total  energy)  rather  than  K  (kinetic  energy)  is  used  for  the 
velocity  or  energy  space  differential  volume  unit.  We  next  invoke  the 
Vlasov  equation  to  allow  a  mapping  of  f  along  a  trajectory  connecting 
the  surface  to  "infinity".  In  doing  so,  we  replace  the  one  factor  of 
E  with  K,  while  elsewhere  setting  E  =  K  ♦  qV  where  q  is  the  particle 
charge  b,  and  V  is  the  surface  voltage.  Thus,  we  write, 

f(K,V,*)  =  AU)  1  (K  +  qV)"(a+1) 
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E 


FeW 

(kTe)2* 


exp(-(qV  +  K)/k  Tg) 


+  B(«|>)  exp(-(K  -  KJ2/*2) 


3.4-3 

The  index  e  covers  both  hot  and  cold  electrons,  and 
F  (</>)  =  gW*n  *  |/,kT/2irm  which  is  the  thermal  flux  multiplied  by  a 
a  function  of  the  pitch  angle.  The  net  electron  current  density  at  a 
surface  is,  of  course. 


J  -  q 
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/d$  f  de  f  k  dK  f (K, V , ip)  cose  sine 
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The  relation  between  the  pitch  angle  ip,  and  the  spherical  polar  angles 
of  the  surface  normal  is: 

ip  (e,Y,tf)  =  arccos[cosY  costf  +  sinY  sine  cosd] 

where  y  is  the  angle  between  the  surface  normal  and  the  magnetic 
field.  These  angles  are  illustrated  in  Figure  3.41-1. 


<P ( 9,  y  ,*)  =  cos"1  [cosy  cose  +  sinY  sine  cos<p j 

Figure  3.41-1. 
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It  is  important  to  note  that  in  composing  f  at  a  surface  from  f  at 
infinity,  the  angular  factor  in  f,  g(i|>),  and  B(ij>),  may  evolve 

dramatically.  Ultimately,  POLAR  will  estimate  the  angular  evolution 
of  the  electron  distribution  function,  as  this  may  be  important  for 
some  narrow  high  energy  distributions  as  well  as  necessary  for  the 
prediction  of  magnetic  field  effects.  However,  since  the  usual 
tendency  is  for  the  repelled  specie  distribution  to  broaden  (POLAR 
currently  assumes  all  surface  and  space  potentials  to  be  negative), 
our  first  guess  will  be  to  assume  f  to  be  isotropic  at  all  surfaces. 

The  energy  integration  limits,  U  and  L,  are  0  and  ®  for  the 
Gaussian  and  Maxwellian  distributions,  but  a  lower  cutoff  must  be 
imposed  on  the  power  law  distribution.  This  cutoff  is  physical  in  its 
origin  as  the  electron  currents  are  finite,  but  determining  it 
accurately  is  not  always  possible.  POLAR  uses  a  100  eV  default  cutoff 
which  may  be  changed,  or  alternatively  the  total  current  for  these 
electrons  may  be  specified  and  a  reasonable  cutoff  will  be  deduced  by 
POLAR. 

POLAR  integrates  each  population  separately.  These  integrations 
are  described  in  Section  4.52. 


3.42  ION  SURFACE  CURRENTS 


POLAR  presently  considers  two  positively  charged  particle 
sources;  one  specie  of  ion  (singly  charged  with  a  variable  mass),  and 
protons.  As  the  attracted  species,  the  calculation  of  the  ion  current 
density  at  a  surface  is  a  non-local  problem  which  often  depends 
critically  upon  the  shape  of  the  orbits  that  bring  ions  to  the  surface 
(Reference  3-2).  That  is,  the  problem  is  generally  numerical  with  few 
exceptions  that  yield  to  analytic  evaluation.  POLAR  calculates  these 
currents  as  part  of  its  sheath  model,  so  the  reader  is  referred  to 
Section  3.60  for  further  information,  and  a  brief  discussion  follows 
here. 

External  to  a  sheath  edge  "orbit-limited"  (Reference  3-2  and 
Section  3.60)  conditions  may  be  assumed  which  will  allow  a  flowing 
Maxwellian  velocity  distribution  to  be  analytically  integrated  to  find 
the  ion  currents  to  the  sheath  edge.  These  currents  are  assigned  to 
representative  particles  that  are  traced  inwards  to  the  object  surface 
to  yield  ion  surface  currents.  This  calculation  is  performed  as  a 
portion  of  the  POLAR  sheath  model  which  is  executed  as  the  CURREN 
module  of  NTERAK  (see  Chapter  5  for  POLAR  code  structure). 


3.50 


ELECTRICAL  CHARGING 


The  electrical  charging  of  the  spacecraft  is  modeled  using  a 
circuit  analogy.  The  plasma  around  the  craft  becomes  a  current  source 
with  a  capacitance  between  the  plasma  and  the  object's  surface.  The 
spacecraft  is  modeled  as  a  network  of  capacitors,  resistors,  and 
voltage  sources.  The  basic  charging  equation  is 

1 ( t)  =  C  V(t)  -  o  V(t)  (3.50-A) 


where  I  is  current,  C  capacitance,  a  conductance,  and  V  is  voltage. 
Each  surface  (the  smallest  mesh  unit  sized  square,  triangular  and 
rectangular  building  block)  contributes  a  component  to  the  current  and 
voltage  vectors. 

Surface  voltages  are  updated  (integrated)  by  timestepping  a 
finite  difference  approximation  to  Eq.  (3.50-A)  (4.51).  This 
integration  frequently  proves  to  be  difficult  because  of  the  wide 
range  of  capacitance  that  can  occur  in  the  C  matrix.  For  instance,  a 
surface  to  plasma  capacitance  might  be 

C  e  9 

f  s  1°  ef/m 

where  A  is  the  surface  area  and  R  is  an  effective  radius,  whereas  the 
surface  to  conductor  capacitance  of  a  dielectric  might  be 


Thus,  a  driving  current  of  10  A/m  would  produce  charging  rates 

6  2  ' 
of  10  volts/sec  and  10  volts/sec.  Obviously,  these  two  extremes 

would  require  different  timesteps  for  a  simple  explicit  integration. 


The  stability  difference  between  the  explicit  and  implicit  forms 
can  be  demonstrated  by  a  simple  scalar  analog. 


Explicit:  C[V ( t^ )  -  V(tj)]  =  I ( tj )  .  at 
Implicit:  C[V(t2)  -  V(t^)]  =  I(t2)  .  at 

Substituting 


I(t2)  =  Ktj)  +  I  *  (V(t2)  -  V(tj)) 


(3.50-B) 


gives 


v(t2)  -  V(tx) 


I(tj)  at 


If  we  take  a  case  of  C  =  10”  f,  I(tj) 

at  =  1  sec,  I'  =  -10~8  A/ volt  we  find 

Explicit:  aV  =  105  volts 
2 

Implicit:  aV  =  10  volts 


10"6  A, 


That  the  explicit  answer  is  unstable  is  indicated  by  plugging  aV 

_3 

into  Eq.  (3.50-B)  giving  I(t2)  =  -10"  A  (explicit)  or 
I(t2)  =  10“^  A  (implicit). 


POLAR  utilizes  both  explicit  and  implicit  timestepping  to  allow 
large  timesteps  for  the  large  capacitances  while  maintaining  accuracy 
and  stability  for  the  smaller  capacitances.  Details  of  implementation 
can  be  found  in  Sections  4.51  and  5.70. 
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3.60 


THE  POLAR  SHEATH  MODEL 


The  concept  of  a  plasma  sheath  requires  definition.  In  general, 
the  plasma  sheath  can  be  defined  to  be  the  region  of  non-neutral 
charge  density  that  shields  a  charged  body  from  distant  plasma.  A 
more  precise  definition  should  distinguish  between  an  "orbit-limited" 
sheath  and  a  "space  charge-limited"  sheath.  Investigations  into 
current  collection  by  Langmuir  probes  (Ref.  3-2,  3-3)  in  the  long 
Debye  length  limit,  have  shown  that  current  collection  is  orbit- 
limited,  i.e.,  on  the  surface  of  a  probe,  distribution  functions  are 
filled  over  a  hemisphere,  and  are  related  to  the  distant  plasma 
distribution  function  by  constants  of  the  motion  or  "orbits".  As  the 
Debye  length  is  shortened,  current  collection  remains  orbit-limited 
until  the  charge  density  is  sufficient  to  cause  the  electric  potential 
to  decrease  faster  than  the  inverse  square  of  the  radial  distance.  At 
this  point,  current  collection  is  said  to  be  space  charge-limited. 

An  important  feature  of  the  orbit-limited  sheath  is  that  the 
particle  currents  to  a  surface  are  independent  of  the  exact  shape  of 
the  potential  well,  making  it  possible  to  derive  general  expressions 
for  currents  and  densities.  The  opposite  is  true  of  the  space  charge- 
limited  sheath  where  currents  and  densities  must  be  calculated 
numerically  by  following  trajectories  in  potential  wells  that  must  be 
consistent  with  the  particle  densities.  The  many  approaches  to  this 
problem  have  been  reviewed  recently  by  Laframboise  (Ref.  3-4). 

POLAR  must  model  the  space  charge-limited  extreme,  which 
dictates  the  use  of  some  trajectory  tracing.  Efficiency  is  maintained 
h  recognizing  that  orbit-limited  conditions  exist  in  the 
Mv.us i-neutral  region  outside  the  sheath,  and  that  trajectories  must  be 
followed  only  inside  the  sheath.  POLAR  thus  makes  a  sharp  sheath  edge 
approximation  to  divide  a  problem  into  the  two  regimes.  Fluxes  from 
"infinity"  to  the  sheath  edge  are  calculated  analytically  using  orbit- 
limited  theory  (Sections  3.42,  4.42.2).  These  fluxes  are  then  assigned 
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(Section  4.42.3)  to  trajectories  that  are  tracked  (Section  4.42.4) 
through  the  sheath  to  determine  particle  densities  in  the  sheath 
(Section  4.42.5)  and  surface  currents  (Section  4.53).  Of  course,  for 
the  self-consistent  probe  problem,  POLAR  must  iterate  between  sheath 
density  solutions  and  Poisson  solutions,  and  for  a  charging  problem  a 
higher  level  of  iteration  updates  the  surface  potentials  and  iterates 
with  the  sheath-Poisson  solution. 

The  sheath  edge  is  nominally  chosen  to  be  the  0.47  kT  potential 
contour.  For  a  spherical  probe  in  a  non-flowing  plasma,  this  is 
consistent  with  previous  investigations  (Refs.  3-5,  3-6).  In  the 
presence  of  net  plasma  flow,  POLAR  maintains  the  0.47  kV  sheath  edge 
choice,  but  it  is  presently  not  clear  what  the  best  choice  for  the 
sheath  edge  will  be  for  high  flow  problems. 

There  are  two  major  approximations  made  in  the  POLAR  sheath 
model.  The  first  is  the  so-called  sharp  sheath  edge  approximation. 
This  assumes  that  there  is  a  sharp  boundary  between  non-neutral  sheath 
and  the  surrounding  quasi-neutral  presheath  region.  For  large  objects 
in  short  Debye  length  plasmas  this  is  a  very  good  approximation.  The 
other  approximation  is  that  thermal  effects  within  the  sheath  are 
small,  i.e.,  from  a  given  position  on  the  sheath  boundary,  that  a 
single  trajectory  is  adequate  to  represent  all  particles  entering  from 
that  position.  This  implies  that  potentials  exist  in  the  sheath  such 
that 


and  that  the  electric  fields  near  the  sheath  edge  are  sufficiently 
strong  so  that  a  velocity  space  element  is  accelerated  rapidly  and  its 
thermal  spread  is  small; 

»th  •  « L 

where  vth  is  the  ion  thermal  velocity,  t  is  the  transit  time  from 
the  sheath  edge  to  the  vehicle,  of  characteristic  dimension  L. 


j*~  _A 


>■* v**.: 


Vl«l 


v 


^'■.■>y.'"y.'.'.T  v  ■  /.■«.  ''.tv' 


REFERENCES,  CHAPTER  3 


3.6-3 


3-2  Laframboise,  J.  G.,  “Theory  of  Spherical  and  Cylindrical 

Langmuir  Probes  in  a  Collisionless,  Maxwellian  Plasma  at  Rest," 
UTIAS  Report  No.  100,  1966. 

3-3  Laframboise,  J.  G.  and  L.  W.  Parker,  “Probe  Design  for  Orbit- 

Limited  Current  Collection,"  Phys.  of  Fluids,  Vol.  16,  N5,  1973. 

3-4  Laframboise,  J.  G.,  "Is  There  a  Good  Way  to  Model  Spacecraft 
Charging  in  the  Presence  of  Space-Charge  Coupling,  Flow,  and 
Magnetic  Fields?,"  in  Proceedings  of  the  Air  Force  Geophysics 
Laboratory  Workshop  on  Natural  Charging  of  Large  Space 
Structures  in  Near  Earth  Polar  Orbit,  AFGL-TR-63-0046,  September 
1962. 

3-5  Parker,  L.  W.,  "Computations  of  Collisionless  Flow  Past  a 
Charged  Disk,"  NASA  CR-144159,  1976. 

3-6  Parrot,  M.J.M.,  L.R.O.  Storey,  L.  W.  Parker  and  0.  G. 

Laframboise,"  Theory  of  Cylindrical  and  Spherical  Langmuir 
Probes  in  the  Limit  of  Vanishing  Oebye  Number,"  Phys.  Fluids, 
25(12),  December  1982. 


4.  COMPUTATIONAL  TECHNIQUES 


This  section  describes  the  algorithms  used  to  implement  the 
physical  model. 

4.10  GRIDS  -  DISCRETIZATION  OF  SPACE 

POLAR  is  a  three-dimensional  computer  code;  that  is,  its 
internal  representation  of  space  allows  variations  in  all  three 
coordinate  directions.  Since  problem  set-up  can  be  extremely  complex 
in  three-dimensions,  the  choice  was  made  to  keep  the  spatial 
coordinate  system  as  simple  as  possible.  Space  is  divided  uniformly 
into  cubes.  The  computer  code  stores  information  about  a  large  set  of 
cubical  volumes,  called  elements.  It  also  stores  values  of  electric 
potential  for  the  corners  of  the  elements.  The  corners  are  referred 
to  as  nodes. 

4.11  STAGGERED  MESH 

The  coordinate  system  used  in  POLAR  is  Cartesian.  This  greatly 
simplifies  object  definition  and  converting  positive  vectors  into 
element  locations.  However,  the  types  of  problems  POLAR  is  designed 
to  handle  are  very  anisotropic.  The  density  and  potential 
perturbations  are  along  the  wake  direction  and  can  extend  for  several 
vehicle  diameters.  To  provide  resolution  in  this  wake  region  but  not 
occupy  an  excessive  amount  of  computer  storage,  a  system  of  staggered 
meshes  has  been  implemented.  The  staggered  mesh  consists  of  square 
layers  of  elements  that  are  only  one  mesh  unit  deep  in  the 
z-direction.  They  are  stacked  upon  each  other  so  that  the  center  of 
each  layer  is  as  close  to  the  wake  center  as  possible  and  still  have 
the  nodes  at  integer  coordinates.  Since  this  extension  always  is  in 
the  z-direction,  the  object  coordinates  can  be  transformed  by  a  90* 
rotation  matrix  so  that  an  arbitrary  Mach  vector  can  be  accommodated. 


The  problem  space  is  unrestricted  in  the  z-direction  so  that  viable 
results  may  be  obtained  for  large  Mach  vectors  in  lower  density  plasma. 

Examples  of  grids  for  two  objects  are  shown  in  Figure  4.11/1. 

4.12.  OBJECT  GRID 

• 

The  object  grid  is  the  space  in  which  the  object  is  defined. 

This  subsection  of  the  grid  space  is  non-stepped  and  is  a  regular 
prism.  The  object  must  be  defined  so  that  it  fits  entirely  within 
this  space. 

The  object  grid  also  serves  as  the  coordinate  reference  point 
for  the  entire  problem.  The  lowest  point  on  the  x,  y  and  z  axis  (low 
leftmost  corner)  is  defined  to  be  the  origin  and  has  the  coordinate 
value  of  (1,1,1) . 


i.«  i.a  s.o  ».•  r.a  «.e  u.o  1x0  no  if.e 


i 

Figures  4.11/ 1A .  Cube  moving  to  left;  4.11/IB.  Rising  quasi-sphere; 
4.11/1C.  Falling  quasi-sphere. 


4.21 


FINITE  ELEMENTS 


4.21.1  GENERAL 

Consider  a  charged  object  isolated  in  space.  The  potential  6 
everywhere  is  given  by  the  solution  to  Poisson's  equation 


v2* 


-p/e 


(4.1) 


The  variational  principle  associated  with  this  equation  is  given 
by: 


6 


1 

7 


(V*)2 


4.dS' 
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where  we  integrate  over  both  the  object  and  boundary  surfaces  (c^, 

CB) . 

To  simplify  things  for  the  purpose  of  illustration,  let  us  fix 
the  potentials  on  these  surfaces  and  assume  zero  charge  density. 

The  equation  then  simplifies  to 


6 


-  0 


(4.2) 


Equation  (4.2)  involves  an  integral  over  the  volume  of  the 
computational  space.  One  way  to  treat  this  integral  is  to  divide  the 
space  up  into  finite  cubic  volume  elements. 


\wv-.vsm  r* 
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/dv^(v^)2-^  /  d \ie\(nY 


e  V. 


In  this  approach  the  potential  t  is  defined  at  each  grid  point,  or 
node,  defining  the  vertices  of  the  elements.  The  potential  inside 
each  element  is  then  trilinearly  interpolated  from  the  values  of  each 
of  its  eight  vertices. 

*e  (x.y.z)  «  NiXyZ 

i  €e 

where  "i"  are  the  nodes  of  element  "e" 
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/dV  \  (V<»2  =  ^2  /dVe  (x.y.z)^ 


The  quantity 


w 


dV  VNxyZ  .  VNxyz 


(4.3) 


is  completely  defined  just  by  knowledge  of  the  shape  of  the  element 
"e"  ( i . e . ,  whether  the  cube  is  empty  or  partially  filled).  For 
screening  purposes,  we  also  require 


V®.  =  /dV  NxyZ  NXJ 
ij  J  e  i  j 


(4.4) 


The  variational  principle  therefore  becomes: 


These  equations  may  be  iterated  upon  until  the  resultant  6  vector 
becomes  the  solution  to  Poisson's  equation. 

The  major  computational  operation  in  the  iterative  set  of 
equations  is  the  evaluation  of  the  matrix-vector  product  M  u.  The 
vectors  0,  u,  and  r  all  have  the  same  number  of  elements  as  the  number 
of  grid  points.  M  contains  the  square  of  this  number.  Such  a  huge 
array  is  impractical  to  store  all  at  once  and  so  M  u  is  evaluated 
using  the  following  implicit  algorithm 

i  ■  £  :*  ■  £  v; 

e  e  ~ 

The  w e  matrices  are  of  reasonable  dimension,  for  example,  8x8  for 
an  empty  cube.  The  residual  r  is  constructed  element  by  element  and 
then  summed.  These  "weight"  matrices  wg  may  be  calculated 
analytically  for  each  type  of  empty  or^partially  filled  volume 
element,  allowed  by  POLAR.  There  are  seven  of  these.  Filled  cells 
are  not  included  in  the  potential  calculation.  This  is  how  POLAR 
treats  filled,  partially  filled  and  empty  elements,  differently. 
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SPECIAL  CELLS 


The  geometry  of  NASCAP/POLAR  objects  can  be  treated  in  terms  of 
a  relatively  small  number  of  volume  cells.  Each  type  has  a  maximum  of 
eight  corner  nodes,  plus  a  node  at  the  center  of  each  possible  surface 
pointing  into  the  element.  The  most  common  volume  element  (designated 
type  0)  is  the  empty  cube  with  no  surfaces.  Other  elements  are: 

a.  The  empty  cube  with  up  to  6  surfaces  (also  type  0); 

b.  The  wedge  element  (type  1); 

c.  The  empty  element  with  a  diagonal  line  (produced  by  a  right- 
triangle  surface  or  a  slanted  thin  plate)  on  one  face  (type  2); 

d.  The  tetrahedron  (type  3); 

e.  The  truncated  cube  (type  4); 

f.  The  slanted  thin  plate  (type  5). 

Each  element  is  characterized  by  (1)  a  standard  orientation; 

(2)  a  set  of  interpolation  functions  (see  4.21.21  for  treatment  of 
surface  nodes);  (3)  the  matrix  W,  given  by  Eq.  4.3,  which  represents 

p  % 

the  operator  -v  in  Poisson's  equation;  and  (4)  the  matrix  V, 
defined  by  Eq.  4.4,  which  handles  the  screening  part  of  Poisson's 
equation. 


4.21.21  INTERPOLATION  FUNCTIONS  FOR  FACE-CENTERED  SURFACE  NODES 
(FCSN'S) 

In  constructing  the  matrices  W  and  V  for  volume  cells  with 
FCSN's  it  is  convenient  to  work  with  the  vector  ip  *  T  4,  where,  for 
corner  nodes,  ^  has  identical  entries  to  the  potential  vector  4,  but 
for  an  FCSN  the  ip  entry  is  the  difference  between  its  electrostatic 
potential  and  the  average  of  that  of  its  corners.  In  terms  of  ip, 
corner  node  interpolation  functions  are  constructed  neglecting  the 
FCSN's,  and  FCSN  interpolation  functions  are  unity  at  the  FCSN  and 
zero  on  all  other  faces.  In  terms  of  these  interpolation  functions, 
the  matrices  W  and  V  are  defined  by 

fl  V*|2  d3r  =  4j  w  4  =  A  \p 

f  42  d3r  =  4J  V  4  =  ii>T  B  ip 


where  the  integrals  are  over  the  element  volume,  and  we  have  defined 
and  B,  which  are  readily  shown  to  be  given  by 

Au  -  f7/  ■  7_Nj  d3: 

bi j  -  /n1  nJ  d3:  • 

F inal ly, 

W  =  TT  A  T 

V  =  TT  B  T  . 

The  matrices  T,  W  and  V  are  given  for  each  element  type  in  the 
succeeding  sections. 
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THE  EMPTY  CUBE  (TYPE  0)  ELEMENT  WITH  NO  FCSN'S 


Standard  Cell  0 
Empty  tril inear  cube 
Orientation:  Arbitrary 
Potential  Functi<?n: 

i  N1 

1  ( 1— x )  ( 1— y )  ( 1— z ) 

2  ( 1— z )  ( 1— y )  x 

3  (l-x)y(l-z) 

4  (l-z)yx 

5  z( 1— y) ( 1-x) 

6  x(l-y)(z) 

7  zy(l-x) 

8  xyz 
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1/54 
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1/54 
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1/108 
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1/27 
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1/54 
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1/54 
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1/108 
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1/54 
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1/54 
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THE  EMPTY  CUBE  (TYPE  0)  ELEMENT  WITH  SIX  FCSN'S 


Figure  4. 
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21.23/1.  Cubical  finite  elements  with  six  face-centered 
surface  nodes  (FCSNs).  The  FCSNs  are  located  on 
the  +x,  +y,  +z  faces  respectively. 
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Figure  4.21.23/2.  Interpolation  functions  for  the  cubical  element  of 

Figure  4.21.23/1. 
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4.21.24  THE  WEDGE  ELEMENT  (TYPE  1) 

Half  Empty  Wedge 

1  <  x+y  <  2 

0  <  z  <1 


Node  Location  Interpolation  Function 
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0 

0 

0 

0 

2 

1 
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(or  Type  I  (Vedge)  Element 


for  Type  I  (Wedge)  Element 


4.21.25  THE  TYPE  2  ELEMENT 


Cube  with  Diagonal 
Orientation:  Line 


Line  on  One  Face 
from  2  to  3 


Node  Location 


Interpolation  Function,  Ni 
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for  Typo  8  (Spool*!  Empty  Cubo)  KUmont 


4.21.26 


THE  TETRAHEDRON  ELEMENT 


7 
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Tetrahedron  (Type  3) 
2  <  x+y+z  <  3 


Node 

Location 

Volume 
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1 

1 

.007756 

1  -  X 

8 

1 

1 

1 

.009542 

x  +  y  +  Z  -  2 

9 

1 

2/3 

2/3 

.032101 

27  x  y  z(x  +  y 

+  z  -  2) 

10 

2/3 

1 

2/3 

.032101 

27  7  y  z(x  +  y 

+  z  -  2) 

11 

2/3 

2/3 

1 

.032101 

27  x  y  z(z  -  x 

-  y) 

12 

2/3 

2/3 

2/3 

.037552 

27  x  y  1 

(Tetrahedron)  Volume  Element 


(Tetrahedron)  Volume  Element 


4.21.27 


THE  TRUNCATED  CUBE  ELEMENT  (TYPE  4) 


Truncated  Cube  (Type  4) 
1  <  x+y+z  <  3 


Node 

Location 

Volume 

1 

0 

0 

0 

0 

2 

1 

0 

0 

-.0380 

3 

0 

1 

0 

-.0380 

4 

1 

1 

0 

.0406 

5 

0 

0 

1 

-.0380 

6 

1 

0 

1 

.0406 

7 

0 

1 

1 

.0406 

8 

1 

1 

1 

-.0709 

9 

0 

2/3 

2/3 

.1119 

10 

1 

1/2 

1/2 

.1499 

11 

2/3 

0 

2/3 

.1119 

12 

1/2 

1 

1/2 

.1499 

13 

2/3 

2/3 

0 

.1119 

14 

1/2 

1/2 

1 

.1499 

15 

1/3 

1/3 

1/3 

.1112 

K(s) 

=  s 

s(S) 

e2  - 

(x  + 

y  +  Z  . 

-  1)  (2 

*3  = 

(X  • 

f  y  +  Z 

-  2) 

5 


0 

(2x  -  y  -  z  +  1)  K(2  -  x  -  y  -  z) 
(2y  -  x  -  z  +  1)  K(2  -  x  -  y  -  z) 
(1  +  x  +  y  -  2z)  e2/3.  +  (l-z)e3 
(2z  -  x  -  y  +  1)  K(2  -  x  -  y  -  z) 
(1  +  x  +  z  -  2y)  e2/3  +  (l-y)e3 

(1  +  y  +  z  -  2x)  e2/3  +  (l-x)e3 

(x  +  y  +  z  -  2)  e3 
27  x  y  7  K(y  +  z  -  1) 

16  x  y  y  z  7(x  +  y  +  z  -  1) 

27  7  y  7  K(x  +  z  -  1) 

16  x  7  y  z  7(x  +  y  +  z  -  1) 

27  7  y  7  K(x  +  y  -  1) 

16  x  7  y  y  z(x  +  y  +  z  -  1) 

K(1  -  x  -  y  +  2z)  K(1  -  y  -  z  +  2 
K(l-x-z+2y)K(2-x-y-2 

7  =  1  -  x 

x-y-z)  y  =  1  -  y 

7  =  1  -  z 


(Truncated  Cube)  Volume  Element 


4.21.28  THE  SLANTED  THIN  PLATE  ELEMENT  (TYPE  5) 


The  type  5  element  Is  treated  as  two  type  1  (q.v.)  elements 


■ 


4.30 


MATRIX  SOLVERS 


4.3-1 


POLAR  (NTERAK)  currently  uses  two  methods  to  sol>'e  matrix 
equations  of  the  form 

HI  -d 

m  •**  ~ 

where  M  is  a  given  matrix,  d  is  data  and  X  is  the  solution  vector. 

at  ~  ~ 

These  methods  are  the  Conjugate  Gradient  Method  and  the  Incomplete 
Cholesky  Conjugate  Gradient  Method  (ICCG). 
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4.31 


CONJUGATE  GRADIENT  METHOD 


This  method  is  used  for  the  Poisson  equation  solution  (4.20, 
4.44)  where  X  «  t>  (potential)  which  can  have  10,000  or  more 
components.  The  next  revision  of  this  document  will  have  a  complete 
discussion  of  this  method. 


4.32 


ICCG,  THE  INCOMPLETE  CHOLESKY  CONJUGATE  GRADIENT  METHOD 


ICCG  is  used  to  solve  the  charging  equations  (4.50,  5.70),  where 
X  «  Vc,  surface  voltages.  Components  of  Vc  generally  number  1000 
or  less.  This  allows  the  entire  problem  to  be  kept  in  the  machine 
(5.73.2).  ICCG  will  find  series  of  approximate  inverses  for  M  finding 

AS 

X  as 

X  -  M"1  d  . 

—  ~ 

It  is  iterative,  but  iterates  on  M-*  as  well  as  X.  A  more  complete 

t*s  ~ 

description  will  be  found  here  in  future  revisions.  Reference: 
Kershaw,  D.  (1978),  "The  Incomplete  Choi esky-Con jugate  Gradient  Method 
for  the  Iterative  Solution  of  Systems  of  Linear  Equations,"  Journal  of 
Computational  Physics,  26,  p.  43. 


4.40  SPACE  CHARGE  AND  CURRENT  COMPUTATION 

This  section  describes  the  numerical  techniques  such  as 
integration,  that  are  used  to  effect  the  models  described  in  Chapter 
3.  In  some  cases,  the  computational  requirements  are  satisfied  by  the 
top-down  structuring  of  simple  subroutines.  In  these  cases,  the 
Chapter  4  discussion  is  deferred  to  Chapter  5  to  avoid  repetition. 

4.41  WEAK  FIELD  IONS,  PRESHEATH  AND  WAKE 

This  model,  presented  in  Section  3.30,  will  be  elaborated  upon 
here  in  future  revisions.  The  reader  is  currently  referred  to  Section 
5.61. 
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4.42  THE  POLAR  SHEATH  MODEL  (TECHNICAL) 

Section  3.60  contains  a.  general  discussion  of  the  POLAR  sheath 
model.  This  section  is  not  designed  to  be  a  complete  discussion,  but 
to  fill  in  the  technical  details  of  the  model. 


4.42.1 


ION  SHEATH  EDGE  ALGORITHM  (SHEATH) 


The  SHEATH  routine  takes  as  input  a  sheath  edge  potential,  PMIN, 
and  the  eight  vertex  potentials  of  a  single  cubic  element,  P(2,2,2). 

It  determines  whether  the  sheath  potential  contour  passes  through  the 
specified  element  and  if  it  does  it  generates  a  number  of  triangles, 
NPART,  with  areas  W(I)  and  center  X(3,I)  which  approximates  the 
equipotential  surface. 

The  sheath  location  proceeds  by  finding  any  edges  whose  vertex 
potentials  bracket  the  sheath  potential.  If  none  do,  NPART  is  set  to 
zero  and  control  returns  to  the  calling  program.  For  the  cases  of 
three  intersections  a  single  triangle  is  constructed  from  the 
intersection  points  with  the  area  calculated  by  the  TRiangle  AREA 
routine.  For  four  or  five  edge  intersections  the  centroid  of  the 
intersection  points  is  found  and  triangles  constructed  using  adjacent 
intersection  points  and  the  centroid.  Thus  for  four  edge 
intersections,  four  triangles  are  formed.  SHEATH  then  would  return 
NPART  =  4  and  the  center  coordinates  of  each  of  the  four  triangles. 


4.42.2 


ION  CURRENTS  TO  THE  SHEATH  SURFACE 


We  calculate  the  current  density  to  the  sheath  edge  by  assuming 
it  to  be  a  perfectly  absorbing  spherical  surface  in  a  flowing  plasma. 
We  assume  that  the  potential  around  the  sphere  is  spherically 
symmetric  and  attracts  ions.  We  utilize  the  coordinate  systems 
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indicated  in  Figure  3.42/1  below  (shown  twice  to  reduce  cluttering) 


Figure  4.42/1. 

and  introduce  the  following  definitions: 


|  =  sphere  radius 

V  =  satellite  velocity 

o 

(r)  =  potential  energy  of  ion  at  r 

n  =  unit  vector  at  position  r  on  sphere  where  normal 

current  density  is  to  be  calculated 

n f  =  unit  vector  in  final  dir|ction  £at  r  =  )  mapped 

>hy 

particles  launched  fjrom  r  =  (a,n)  with  velocity  v 
x-z  plane  =  plane  determined  by  n  and  VQ 


»  > 

^  a  angle  between  n  and  VQ 

Qm  ■  polar  angle  of  particle  for  (n  «»,  nf) 

i  ■  angle  between  x-z  plane  and  orbital  plane 

W  -  <2*  |exP  -(vo  -  V  /2vT 

m  a  ion  mass 

v2  a  kT/m 

For  a  particle  moving  in  a  central  potential  the  conserved  quantities 
are  (e  *  m  »  1): 

12  12 

■p  v  +  <P(a)  =  ^  vQ  =  E  Energy 


L  =  vasine 

i 

* 

The  normal  current  density  j(r) 
is  given  by 


Angular  Momentum 

Azimuth 
♦  ■> 

a  point  r  =  (a,n)  on  the  sphere 


*  -  *  »  » 
j  =  j(a,n)  =  J  (v.n)  fQ(v0)  dJv 


=  (2»  Vy) 


-3/2 


exp  |  (V*  -  2V0  +  Vo)/vT 


x  v  cose  sine  dv  de  dtf 


where 


cos^  =  cos?;  cose^  -  sinC  sine^cosd 


w 

6JV0’e)  =  3  sine/^7 

a  r 


1  _  »  s1n2e  + 


-1/2 


Performing  the  0  integration,  which  can  be  done  analytically,  and 
using  energy  conservation. 
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2  -3/2  f  2  “vo/2vT 

j  .  (2irVj)  /  vQ(v2  -  2$(a))  e  7  F(vQ)  dvQ 


>ax(Vo)  -v  V  COSC  cose  /v?  -V^/2v! 

F(v0)  -2 .  J  e  0  s  T  e  o  T 
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t  /voVo  sin*sinM 

M — 3  ; 


sinD  cose  de 


where  I  is  the  modified  Bessel  function  of  zero  order, 
o 


For  numerical  calculations  we  define  t  =  x/ 3.75  and  approximate 


lo  h» 


I(x)  =  1  +  3.5156229t2  +  3.0899424t4  +  1.2067492t6 


+  .2659732t°  +  .0360768t 


e  <  1.6  x  10"7 


10  4 


.0045813t12  ♦  e 


for  -3.75  <  x  <  3.75 
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x1/2e"x  I  (x)  =  .39894228  +  .01328592  _1 
o 

+  .00225319t-2  -  . 001 57565t — 3 
+  .00916281t-4  -  .02057706t'5 
+  .02635537-6  -  .01647633t“77 


+  ,00392377t-8  +  e 


c  <  1,9  x  10' 


for  3.75  <  x  < 


For  an  inverse  square  potential 


emax  =  1T^2,  and  ttie  chan9e  ’n  P°^ar  angle  can  be  found 


analytical ly 
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(sin2e  -  b2) 


(b2  -  sin2e) 


•  in-1  sin  9  V  ;  sirre  -  b‘  > 

\  1  -  b 2  / 


/  2  2  \^2 
sinh-1  /  b  ---Sljj  ±  j  ;  sin 


2e  -  b2  <  0 


where 


b2  B  -Liiii-l —  <1  (0  <  E  <  <*>) 

E+|<P(a)| 


sinh_1x  =  an  x  +Vx2  +  1 


Note  for  1  -  b  «  1,  eg  may  be  >2ir,  i.e.,  the  particles  may 
execute  a  spiralling  orbit.  Accuracy  may  require  that  «vo,  «e  not 
produce  large  «es. 


POLAR  is  currently  using  a  temporary  approximate  model  for 
initial  velocities  that  is  described  here.  This  model  will  be 
replaced  when  the  new  model  is  ready.  Initial  velocities  are 
approximated  by  adding  a  plasma  rest  frame  characteristic  velocity  to 
the  Mac b  velocity,  (spacecraft  velocity  normalized  by  the  square 
root  of  ( kT/m) . )  The  characteristic  velocity,  Vc>  is  constructed  by 
first  realizing  that  inside  the  sheath  edge  the  density  contribution 
of  a  trajectory  is  simply  a  continuity  calculation  (convergence 
effects  come  from  the  convergence  of  trajectories).  Thus  we  estimate 
|  V  |  by  dividing  the  orbit-limited  flux  obtained  for  a  totally 
absorbing  surface  (Laframboise  and  Parker,  ref.  4-4)  by  a  simplified 
form  for  the  orbit-limited  density  (accurate  in  the  low  potential 
limit). 


where  <p  =  eV/kT,  and  the  ion  acoustic  speed  /kT/m  has  been  isolated 
to  indicate  the  usual  POLAR  velocity  normalization.  The  direction 
is  the  normalized  inward  E  field 

A 

E 

In  the  absence  of  flow,  this  result  is  exactly  the  result  that  would 
be  obtained  from  the  calculation  of  the  velocity  and  density  moments 
of  the  orbit-limited  distribution  function. 


assign|d  to  Vc 


Our  present  (temporary)  treatment  of  flow  is  more  approximate. 
The  initial  sheath  particle  velocity,  V$,  is 


* 

V. 


V  vc 


If  (»M  ♦  Vc)  •  E  >  O 


if  vv 


* 

•  E  <  0 


where  the  conditional  insures  that  V$  is  always  directed  into  the 
sheath. 


4.42.3  SHEATH  PARTICLE  ASSIGNMENT 

Each  volume  element  of  a  problem  is  inspected  for  the  presence 
of  the  sheath  edge  equipotential  as  described  in  Section  4.42.1.  Each 
triangular  subsurface  of  the  sheath  is  a  potential  sheath  particle; 
however,  many  times  a  portion  of  an  equipotential  is  not  really  a 
source  of  current.  This  is  assumed  to  occur  when  there  exists  just 
"outside"  the  sheath  (in  the  anti  E  direction)  a  portion  of  the 
object,  or  a  high  potential  region  of  the  opposite  sign.  Both  of 
these  conditions  are  checked  by  calculating  the  •’’nward  initial 
velocity  for  the  particle  as  per  Section  4.42.2,  reversing  it,  and 
tracking  the  particle  backwards  through  two  volume  elements.  If  no 
"obstacles"  are  found,  the  particle  is  assigned  a  current  or  weight 
and  placed  in  a  particle  list.  This  list  is  later  read  and  the 
trajectories  advanced  as  described  in  Sections  4.42.4  and  5.62. 
Finally,  the  sheath  currents  and  velocities  are  not  calculated  for 
each  particle  but  interpolated  from  a  pre-calculated  table  of  values. 


4.42.4 


TRAJECTORY  TRACKING 


Trajectory  tracking  can  be  an  expensive  endeavor,  and  a  source 
of  unpredictable  error.  To  combat  these  problems,  POLAR  uses  two 
different  methods  to  follow  ion  trajectories  (presently,  there  is  no 
tracking  of  electrons). 

The  full  step  method  is  used  in  empty  elements  that  do  not  touch 
the  object^where  complex  E  fields  are  not  anticipated.  For  these 
elements,  E  at  the  cell  center  is  used  for  the  entire  cell,  and  a 
single  step  parabolic  trajectory  is  calculated  for  the  element.  This 
is  accomplished  by  analyzing  independently  the  three  components  of  the 
equation 


xi  =  xi-l 


for  the  shortest  time,  t,  that  a  particle  needs  to  reach  an  element 

face.  Negative,  imaginary  and  zero  t’s  are,  of  course,  rejected.  A 

number  of  special  conditions  may  occur  involving  round-off  errors  and 

the  traversal  of  exceedingly  small  paths  in  the  corner  of  elements. 

The  treatment  of  these  problems  are  discussed  in  detail  in  Section 

5.62.22.  Following  the  choice  of  the  shortest  valid  time,  the 

trajectory  is  advanced  to  another  (or  possibly  the  same)  element  face, 

where  its  new  total  energy  is  checked  aginst  its  original  value.  The 

->2  + 

new  total  energy  is  1/2  mV  +  eV(x),  where  V(x)  is  the  bilinear 
value  calculated  for  the  exit  location  on  the  exit  face  of  the 
element.  The  energy  is  renormalized  by  adjusting  the  magnitude  of  V 
without  modifying  its  direction. 


For  volume  elements  that  border  the  object,  more  complex  E 
fields  are  anticipated  so  POLAR  uses  a  slower,  but  more  accurate, 
step-push  method  where  Eq.  (1)  is  integrated  using  timesteps  estimated 


to  be  approximately  0.1  of  the  element  traversal  time.  At  each  step, 
tT  is  determined  by  analytically  differentiating  the  trilinear 
potential  function  (Section  4.20).  The  step-push  method  and  the 
routines  that  affect  it  are  discussed  in  greater  detail  in  Section 
5.62.22. 

POLAR's  sliced  grid  system  (Section  4.11)  forces  additional 
computational  considerations  on  the  trajectory  tracking  because  only 
small  set  of  potentials  are  stored  in  core  at  any  one  time. 

Potentials  are  paged  in  and  out  in  slices  at  nodes  of  a  constant  z 
value.  As  a  result,  trajectory  tracking  is  controlled  by  a  "pusher" 
that  sweeps  back  and  forth  in  z,  advancing  all  trajectories  through 
the  space  between  z  and  z+l.  Trajectories  moving  opposite  the  pusher 
are  written  out  to  disk  and  picked  up  on  the  return  pass  (Section 
5.62.22).  Although  this  complicates  the  coding  somewhat,  there  is 
little  loss  in  efficiency,  and  a  bonus  in  that  trapped  orbits  can  be 
simply  controlled  by  limiting  the  passes  of  the  pusher. 

Magnetic  field  effects  are  also  included  in  the  POLAR  ion 
trjectories.  The  techniques  used  to  add  B  effects  were  presented  in 
the  quarterly  report  of  December  1983  (SSS-R-84-6486) .  Future  manual 
revisions  will  have  that  discussion  included  both  here  and  in  Chapter 
5. 

4.42.5  SHEATH  ION  DENSITIES 

Once  a  sheath  edge  surface  has  been  located  and  subdivided 

(Section  4.42.1),  the  input  current,  J^,  calculated  (Section  4.42.2) 

and  that  current  assigned  to  a  representative  particle,  g,  (Section 

4.42.3),  the  particle  trajectory  is  followed  inward  as  described  in 

Section  4.42.4.  Ion  densities,  n^  are  determined  in  each  cell  by 

observing  that  if  each  trajectory,  j,  represents  a  constant  current 

J..  =  dq../dt,  each  trajectory  makes  a  contribution  to  the  overall 
ij  ij 

element  density  of 


1 


4.4-11 


J  .  .  At 
ij 

element  volume 


where  At  is  the  time  required  to  cross  the  volume  element.  The 
total  density  is  just 

"i  -  £  a"u  • 

j 

This  has  been  dubbed  the  method  of  weighted  deposition  (Ref.  3-5).  It 
can  be  seen  that  acceleration  effects  and  convergence  effects  are 
accounted  for  by  the  At,  and  the  respectively. 

This  method  demands  a  large  number  of  particles  for  good 
statistics  and  we  have  found  that  the  three  to  six  particles  per 
sheath  volume  element,  chosen  by  the  sheath  edge  algorithm  (Section 
4.42.1),  work  quite  well.  Problems  in  accuracy  can  still  be 
anticipated  when  there  exists  repulsive  regions  within  a  sheath,  or 
when  the  method  is  being  incorrectly  applied  to  an  orbit-limited 
problem  where  particles  might  numerically  diffuse  into  allowed  trapped 
orbits.  In  this  case  repeated  orbits  would  give  erroneously  high 
densities.  Even  in  strongly  space  charge-limited  sheaths,  unusual 
geometry  could  lead  to  trapped  orbits,  so  POLAR  sets  a  user  controlled 
limit  on  the  number  of  front-to-back  pushing  sweeps  (Section  4.42.4) 
to  control  this  problem. 

Finally,  these  sheath  ion  densities  are  known  as  RHOI's  in  POLAR 
and  are  calculated  by  the  CURREN  segment  of  NTERAK.  The  ultimate  use 
of  these  densities  in  the  Poisson  solution  are  discussed  in  Section 
4.43.2. 
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4.43  CHARGE  DENSITY 


4.4-12 


4.43.1  ELECTRONS 

POLAR  presently  considers  only  negative  potentials.  Thus 
electrons  are  repelled  and  are  approximated  by  an  isotropic  Boltzmann 
equilibrium  distribution,  i.e., 

ne  =  nQ  exp(eV(x)/kT)  . 

This  approximation  may  be  invalid  near  weakly  repelling  surfaces, 
space  potential  barriers,  and  in  magnetically  insulated  regions. 

Other  conditions  may  arise  where  the  electron  distribution  will  not  be 
isotropic  and  a  Boltzmann  distribution  would  not  be  justified.  As 
positive  potentials  are  introduced,  or  as  other  conditions  require,  a 
more  elaborate  electron  model  will  be  adopted. 


4.43.2  ION  CHARGE  DENSITY 

Ions  are  considered  to  be  the  attracted  specie  in  POLAR.  This, 
plus  an  allowance  for  possibly  high  Mach  numbers,  means  that  ion 
densities  may  not  be  determined  by  any  local  approximation.  Thus  ion 
densities  are  currently  determined  by  two  methods:  Weak  field  ions 
(Section  4.41)  known  in  the  POLAR  coding  as  GI's  (geometric  ions);  and 
sheath  ion  densities  (Section  4.42)  known  in  the  coding  as  RHOI's. 

GI's  are  determined  at  the  onset  of  a  calculation  and  remain 
unchanged  thereafter.  The  RHOI's  are  calculated  whenever  a  CURREN 
step  (the  sheath  ion  tracking  process)  is  called  for.  Immediately 
following  a  CURREN  step,  POLAR  creates  from  these  two  data  sets,  an 
ultimate  ion  density  list,  the  DION's  that  are  used  in  the  Poisson 
calculation.  This  is  done  by  choosing  RHOI's  for  elements  inside  the 
sheath,  and  GI's  for  points  outside.  For  elements  containing  a 
portion  of  the  sheath  surface,  the  GI  value  is  currently  used  instead 
of  the  RHOI. 


4.44 


THE  CHARGE  STABILIZED  POISSON  ITERATION 


4.4-13 


The  Poisson  equation  can  be  written  dimensionlessly  as 
-v2*  -  L"2  -  ne)  (1) 


where 


t  =  eV/kT,  L‘ 


eo  kT/No  ^  *  x2/h? 


is  the  dimensionless  Debye  length,  Nq  is  the  ambient  density,  n,.  = 

N./N  ,  n  *  N  /N  ,  and  the  Laplacian  is  also  normalized  by 
X  o  e  e  o 

n .  The  calculation  of  n.  and  n  is  discussed  in  Section  4.43. 

i  e 

POLAR  solves  this  equation  on  its  discrete  mesh  of  uniform  spacing  h, 
using  the  finite  element  method  described  in  Section  4.21. 


The  traditional  approach  to  the  solution  of  equation  (1)  has 
been  an  explicit  iteration  of  the  form 


-vV  .  l-2[ni(«v-1)  -  (2) 

where  v  is  the  iteration  index,  and  the  charge  density  is  determined 

using  the  potentials  of  the  previous  iteration.  This  method  can  be 

shown  to  be  unstable  (ref.  4-2)  when  the  Debye  length,  x,  becomes 

small  with  respect  to  other  scale  lengths  of  the  problem.  This  can  be 

understood  by  considering  that  a  smooth  potential  variation  over  a 

2 

distance  of,  say,  1000  x,  would  require  a  smooth  V  t>  (the  'second 

derivative1)  which  is  in  turn  given  everywhere  by  the  charge  density. 

But,  maintaining  a  smooth  charge  density  distribution  is  difficult 

when  any  errors  in  determining  (n  -  n.)  are  multiplied  by  a  huge 
-2  e  1 

L  .  There  is  one  effective  remedy  to  this  dilemma  due  to  Parker 
(ref.  4-2),  but  the  process  reported  here  appears  to  be  more  efficient 
in  the  short  Debye  length  limit.  This  method  involves  the  combination 
of  two  concepts.  One  uses  a  partial  impl icitization  of  the  repelled 
density  (ng,  here)  (ref.  4-3).  The  other  simply  reduces  the  charge 
density  to  an  acceptable  level  whenever  the  first  method  is  inadequate 


4.4-14 


Suppose  a  plasma  of  ambient  density  NQ  and  temperature  T 
consists  of  Boltzmann  electrons,  N  (r)  -  N  exp(d(r))  and  ions  of 
known  density  N^r)  «  n.(r).  The  normalized  charge  density 

is  then  given  by 

q(MV(r))  -  L"2  [n.(r)  -  exp  Uv(r))]  (3) 

Equation  (3)  may  be  linearized  about  the  previous  potential  iterate 

aUv)  =  »(*”-*)  *  a'U'-1)  •  («v  -  iT1) 

*► 

where  q‘  -  sq/sd,  and  the  r  dependence  has  been  dropped  for  clarity. 
With  this  expression  we  may  write  the  implicit  Poisson  iteration  scheme 

-vV  -  q,(*v_1)  *  =  q(^v_1)  -  q'(*v_1)  *  <iv"1  (4) 

Though  it  is  not  immediately  obvious,  the  implicit  character  of 
(4)  makes  it  more  stable  than  scheme  (2).  This  can  be  understood  by 
realizing  that  in  equation  (3)  the  electron  density  was  treated  as  an 
independent  variable,  whereas  in  (4)  the  electron  density  is 
determined  simultaneously  with  the  potential,  both  being  consistent 
with  the  ion  density. 

The  finite  element  approximation  (Section  4.21)  to  (4)  produces 
the  matrix  equation 

£  (w(e)  -  T'(e)  v{e))  *  =  s  -  ^(e)  *  ^v_1  (5) 

e 

where  S  is  derived  from  q  by  the  following  analysis: 

For  L  >  1,  S  is  simply  the  total  charge  associated  with  each 
node,  q.  However,  for  L  «  1,  numerical  noise  and  features  like  a 
sheath  edge  which  may  span  only  a  few  x,  become  incorrectly  amplified 


when  the  q  determined  at  a  point  becomes  multiplied  by  the  entire 

nodal  volume.  When  it  is  not  possible  to  reduce  the  zone  size, 

stability  can  be  preserved  by  replacing  Q  (and  Q')  with  a  reduced 

value  S  (S')  which  is  calculated  to  be  the  maximum  allowable  charge 

for  the  element.  Because  of  the  artificial  amplification  argument,  S 

is  often  the  more  realistic  total  for  an  element.  Before  deriving  S, 

we  define  the  barometric  potential  ^  =  zn(n..)  which  is  the 

potential  for  which  Q  «  0  and  note  that  it  is  important  that  S  *  Q  as 

t  *  if  quasineutral  regions  are  to  be  modeled  correctly.  To 

determine  S,  consider  a  capacitor  with  potential  difference 
2 

(dk  -  d),  area  h  ,  and  a  separation  of  h.  The  charge  qc  on  this 
capacitor  is  given  by 

‘o'-2 

qc  =  CaV  *  -  d)kT 

In  the  units  of  our  previous  q,  qc  becomes 
qM  =  °^b  ~  ^  ~  °^b  ~  ^ 

which  is  the  maximum  allowable  charge  per  element,  with  the  parameter 
a,  adjusted  to  insure  that  qM  is  maximized.  Thus  at  each  node,  we 
choose  for  the  charge 

|  S  |  =  min  (  |qM  } ,  |  q  |) 

with 

-o  for  S  «  qM 

_2 

L  exp^  for  S  =  q 

Actually,  S  and  S'  are  smoothed  in  POLAR  to  decrease  numerical 
noise  and  spatial  potential  oscillations.  This  involves  forming  the 
linear  screening  term 


where 


SCRN  «  £  (2  •  S'  (?)  +  I') 


3'  «Ej  V(I)  •  S(*(I)) 

where  I  indexes  the  nodes  of  an  element  and  V(I)  is  a  nodal  volume 
normalized  by  a  cubic  element  volume  of  one;  similarly  for  i>.  Also 
smoothed  is  the  nodal  charge  Q(I), 

Q(I)  =  j  (2  *S(?)  ♦  S(4( I) ) )  . 

Additionally,  POLAR  can  output  the  value  S(d)  as  QUSD,  the  element 
centered  charge  actually  chosen  by  this  algorithm. 

_ tp\ 

Finally,  the  0(1),  and  SCRN  are  used  for  S  and  S>  '  in  Eq. 

(5). 


The  effect  of  this  algorithm  is  this:  If  a  problem  has  been 
specified  where  a  boundary  potential  would  be  screened  in  less  th?n  a 
zone  or  two  (the  limit  of  any  code's  resolution),  sufficient  sheath 
charge  will  be  redistributed  so  as  to  allow  the  potential  to  be 
screened  over  the  minimum  number  of  zones  that  are  consistent  with 
stability. 

The  charge  stabilization  algorithm  is  effected  by  the 
subroutine,  QSELT,  and  QSCRN  which  are  further  describeo  in  Section 
5.50.  Tests  of  this  method  are  presented  in  Appendix  C. 


4.50 


CHARGING  MODEL 


4.51.  CIRCUIT  MODEL 

POLAR's  circuit  model  was  introduced  in  Section  3.40.  Here  we 
describe  the  details  of  the  time-integration  of  the  basic  charging 
equation,  3.40-1,  repeated  here. 

I ( t )  *  C  V(t)  -  a  V(t) 


where  I  is  current,  C  capacitance,  a  conductance,  and  V  is  surface 
voltage.  We  first  difference  this  equation,  evaluating  the 
conductance  term  at  the  advanced  time  (implicit)  and  the  current  at 
the  retarded  (explicit)  time. 


C 


(V(t2)  -  VUj)) 


-  a  V(t2) 


I(tj) 


or 


C 


*  (!(V  ■  !(ti}) 


I ( tx )  -  a  V(t1) 


Section  3.40  explored  the  difficulties  associated  with  the 
explicit  current  dependence.  The  implicit  approach  replaces  I(t^) 
with  I ( t ^ ) *  approximated  as 


I(V(t?))  =  I (V( t, ) )  +  4i 


*  (V(t?)  -  V(t,)) 


Substituting,  we  get  the  implicit  formulation 

•  (  V(t2)  -  V(tj)J  -  I(t2)  -  o  V(tj) 

(4.51-1) 

The  dl/dV  term  stabilizes  the  problem  by  increasing  the  matrix 
entries  on  the  diagonal.  Physically,  the  al  ( surf ace=i ) / a V  (surface  i) 
will  be  non-positive  since  surfaces  charge  more  slowly  as  the  voltage 
decreases  (becomes  more  negative).  Currently,  no  surface  to  surface 
interactions  are  included  so  the  current  derivative  matrix  is  diagonal. 

Unfortunately,  due  to  the  complexity  of  the  plasma  interaction, 
the  dl/dV  in  Eq.  (4.51-1)  is  not  trivial  to  evaluate;  so  we  must  use  a 
predictor-corrector  type  approach.  We  may  omit  the  dl/dV  term  from 
(4.51-1)  to  return  to  the  explicit  form,  which  may  be  solved  for  an 
estimate  of  V(t0).  Anticipating  the  possible  instability  of  the 

~  C 

explicit  form,  the  aV  from  t^  to  t^  is  limited  by  the  input 
quantity  OVUM.  With  this  new,  albeit  rough,  estimate  of  V(t2)  we 
could  run  a  complete  Poisson  current  sequence  to  get  a  aI  estimate. 

But,  because  of  the  expense  of  a  complete  Poisson  current  step,  we 
leave  the  ion  currents  constant  (otherwise  a  particle  pushing  step 
would  be  required),  and  obtain  aI  from  the  electron  current  algorithms 
alone  (4.50).  This  will  provide  an  estimate  of  aI/aV  sufficient  to 
solve  (4.51-1)  implicitly  for  V(t2). 

To  discuss  the  solution  to  Eq.  (4.51-1),  we  abbreviate  it  as 

M  .  AV  =  R  (4.51-2) 


where  M  include  the  capacitance,  conductance  and  dl/dV  matrices.  When 


4.5-3 

the  number  of  vector  components  is  not  too  great  (<1000),  we  have 
found  the  Incomplete  Cholesky  Conjugate  Gradient  (ICCG)  method  to  be 
an  efficient  means  of  solving  (4.51-2)  (see  Section  4.30). 

Experience  has  shown  that  ICCG  is  most  effective  when  M  is 
diagonal  or  nearly  diagonal  (diagonal  elements  »  off  diagonal 
elements).  To  see  how  M  may  be  improved,  write  (4.51-2)  as 

(Mp  M2, - Mc)aV  *  R  (4.51-3) 


If  surface  1  connects  to  infinity  (conductor  0)  and  conductor  C,  and 
we  consider  only  the  capacitance,  we  would  have 


'C10  “C1C 


V 


'1C 


*1  * 


'1C 


I 


and  M, 


-C 


CO 


) 


where  CiC  »  C1Q,  CCQ. 


(That  this  is  a  legitimate  example,  see 
the  complete  sample  problem  worked  in  Appendix  A.)  It  is  the  off 
diagonal  entries  of  C^c  that  need  to  be  removed.  This  is 
accomplished  by  transforming  (4.51-3)  to 


aVi  -  aVc 


(Mp  M2  ,-,  Mc  +  Mj) 


=  R 


AV, 


A  column  transformation  for  each  surface  will  "clean  up"  the  upper 
right  triangle  of  M,  while  producing  a  transformed  potential  vector 
where  surface  potentials  have  been  replaced  by  the  potential 
difference  between  the  surface  and  the  underlying  conductor.  The 
lower  left  triangle  of  M  is  diagonalized  and  symmetrized  to  the  upper 


by  similar  row  additions  with  corresponding  transforms  of  R  on  the 
right  hand  side.  Currents  (in  R)  to  surfaces  remain  unchanged,  but 
currents  to  conductors  are  replaced  as 

k*  IS  !S 
S 

where  the  sum  is  over  all  surfaces  connected  by  capacitance  or 
conductance  to  the  main  conductor,  C;  other  conductors  are  treated  as 
surfaces  and  referenced  to  C-, .  The  a  and  V  on  the  right  hand  side 
are  treated  identically  to  o,  C  and  V  on  the  left.  Finally,  the  dl/dV 

«  EB  ~ 

matrix  is  calculated  for  the  transformed  I  and  V  guaranteeing  that  it 
will  be  diagonal. 

Another  feature  of  POLAR's  charging  model  will  change  the 
previous  transformations.  This  happens  when  NTERAK  recognizes  that 
the  lowest  estimate  of  the  ion  flux  (ambient  ram  conditions  including 
shadowing)  exceeds  the  greatest  estimate  of  the  primary  energetic 
electron  flux,  and  the  surface  potential  is  near  zero.  Physically,  if 
kthe  magnitude  of  the  surface  potential  drops  to  near  -k  Tg  cQol 
(typically  1  volt)  the  flux  of  cool  electrons  will  prevent  the  surface 
from  charging  positive.  These  millivolt  sensitivities  are  difficult 
to  follow  in  a  code  that  is  concerned  with  kilovolt  charging.  Thus, 
such  a  surface  will  be  spotted  (this  is  currently  implemented)  and 
have  its  potential  fixed  at  -k  Tg  CQol  for  the  upcoming  charge  cycle. 

This  will  also  occur  when  a  presently  nonexistent  routine  in 
NTERAK  will  recognize  the  required  conditions  for  a  surface's 
potential  to  be  controlled  by  a  E  .  n  =  0  condition  on  the  surface. 
This  may  occur  when  a  secondary  or  photoelectron  space  charge  density 
becomes  large  enough  to  form  a  small  barrier  to  the  low  energy  portion 
of  the  emitted  spectrum.  Such  a  surface  will  be  flagged  and_^get  its 
potential  floated  in  the  Poisson  solution  according  to  the  E  .  n  =  0 
condition,  while  being  held  fixed  during  the  circuit  solution. 


This  fixing  is  not  compatable  with  the  V  transformation,  so 
POLAR  is  forced  to  solve  the  circuit  model  with  the  original 
equations.  Accuracy  does  not  suffer,  but  ICCG  will  require  more  time 
for  the  same  level  of  convergence. 

Other  conditions  will  also  arise  that  will  require  a  surface 
cell  to  be  held  at  a  fixed  potential. 


4.52 


ELECTRON  CURRENTS,  PRIMARY,  SECONDARY 


4.5-6 


The  POLAR  electron  environment  is  described  in  Sections  3.15  and 
3.31.  This  section  explains  the  integration  procedures  used  to  obtain 
the  net  electron  currents  to  a  surface  due  to  primary,  secondary,  and 
backscatter  electrons.  Further  information  concerning  the  code 
mechanics  and  subroutine  relations  can  be  found  in  Section  5.70. 

4.52.1  SECONDARY  ELECTRONS 

The  secondary  electron  yield  coefficients  used  in  this  section 
(4.52.3,  4.52.4,  4.52.5)  are  calculated  using  the  proven  techniques 
and  theories  developed  for  NASCAP.  The  reader  is  currently  referred 
to  Reference  4-1  for  a  description  of  these  methods. 


4.52.2 


BACKSCATTER  ELECTRONS 


IfWWOPC  i  iXMiKiWV  iWWWim  >  VXWtJgCf,  'M&m* £HE*£^&. 
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4.52.3 


INTEGRAL  OF  THE  MAXWELLIAN  DISTRIBUTION 


The  current  Ju  of  electrons  of  charge  q  to  a  surface  at 
n 


voltage  V  due  to  the  Maxwellian  portion  of  the  spectrum  is  given  by 


JiL 


Zn 


(kT)‘ 


/  d*  / 


»/2 


sine  cose  de  g(E,<p  (tf,e)) 


ao 

■l 


K  dK  exp[-(qV  +  K)/kT] 


L  =  max(-qV,  0) 


The  lower  kinetic  energy  limit  L  is  chosen  to  exclude  orbits 
that  cannot  energetically  connect  to  infinity.  The  function  g  is  a 
function  of  the  pitch  angle  i|>  (see  Section  3.31)  and  total  particle 
energy  E.  We  are  concerned  here  with  the  integral  over  kinetic 
energies,  so  the  angle  integrals  will  be  performed  assuming  g  to  be  a 
constant  function  of  value  unity,  so  as  to  give  the  correct  current 
for  an  isotropic  flux. 


The  flux  of  electron  generated  secondary  and  backscatter 
electrons  is  obtained  by  adding  a  yield  function  Y(K,tf,e)  to  the  above 
integrals  (Section  3.33).  POLAR  presently  replaces  Y  with  an  angle 


y&y 

i 


S3S 


rf>v-a 
MM 


i 

■vV;: 


»  ■  M  ■ 
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For  arbitrary  Y,  the  integral  must  be  performed  numerically.  It 
is  also  desirable  to  divide  up  the  spectrum  in  a  manner  that  covers 
the  larger  fluxes  at  low  energies  without  ignoring  the  high  energy 
tail  of  the  Maxwellian  spectrum.  A  logarithmic  spacing  is 
accomplished  by  the  substitution 

K  -  -kT  lnx  . 

Thus  we  have 


A  l 


Y(K(x)}  lnx  dx 


-L/kT 

where  xu  *  e  ,  and  xl  =  0.  Since  lnx  is  singular  at  x  «  0,  the 
lower  limit  is  set  to  xl  »  0.01  *  xu  and  the  omitted  portion  of  the 
spectrum  approximated  by  xl  *  ln(x).  The  summation  is  performed  using 
Simpson's  rule  and  20  points. 


.  \  A  L.S  -  m  “»  Jr  -  •  , 
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4.52.4 


INTEGRAL  OF  THE  POWER  LAW  DISTRIBUTION 


The  discussions  of  angular  dependence  in  the  flux  integral  given 
in  Section  3.31  and  4.52.3  also  apply  here,  so  we  will  limit  this 
treatment  to  the  energy  integral 

KU  _ 

(A)  J  .  aq  f  Y(k)  .  (K  +  qV)-(o+1)  K  dK 

*4l 

where  J  is  current,  Y  is  secondary  or  backscatter  yield,  K  is  kinetic 
energy,  a  is  a  constant  (a  «  wA  for  isotropy),  q  is  charge,  and  V  is 
surface  potential.  For  the  limits  we  choose 

KL  =  MAX  (0,  EL  -  qV) 

KU  =  MAX  (EU,  EU  -  qV) 

where  EL  is  a  physical  cutoff  (default  *  100  eV)  and  EU  is  imposed 
sufficiently  high  as  to  avoid  significant  error  {default  * 

1  x  109  eV). 

The  first  step  is  the  transformation 
X  =  K  +  qV  , 
which  gives 


XU  _ 

J  .  aq  f  Y ( K ( X ) )  .  [X_a  -  qV  X"(a+1)]  dX 
•'XL 

where  XL  =  max(qV,  EL)  and  XU  =  max(EU  +  qV,  EU). 

Since  a  can  be  as  large  as  3.0,  this  spectrum  is  strongly  peaked 
towards  lower  energies,  which  implies  that  a  nonuniform  spacing  of 
integration  points  is  desirable.  This  is  easily  accomplished  by  the 
substitutions. 


»  j  r_*  -j  j  V  -V 
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x  «  y— 1  / ( <»—l )  ^  for  first  term,  and 

1/a 

x  «  z~  '  ,  for  the  second  term 
of  the  previous  integral,  which  leads  directly  to 


J  *  aq 


ill 

*; /  Y  dz 

J  71 


where  yl  =  xl  ~  ,  etc.  Notice  that  these  choices  produce 

integration  weights  of  value  unity.  The  numerical  integration  is  done 

over  20  points  spaced  evenly  in  y  and  z.  These  transformations  are 

very  strongly  biased  towards  the  lower  energies  thus  the  upper  cutoff 

9 

was  chosen  quite  high  (1  x  10  eV)  to  force  good  coverage  of 
intermediate  energies  where  Y  might  be  peaked. 

A  method  with  variable  bias  was  also  investigated.  This 
utilized  for  Eq.  (A),  the  substitution 

K  =  x'1/fi  -  S 


dK  *  -  j  x-(1+1/6)  (jX  „  w(x)  dx 


This  method  has  the  ability  to  adjust  the  bias  with  e,  and  center  the 
integration  points  about  an  energy  related  to  S.  This  method  is 
inherently  slower  due  to  the  calculation  of  the  weights  w(x),  and 
appeared  to  offer  no  great  advantage  over  the  previous  method.  It  is 
not  presently  used  by  POLAR,  but  remains  an  option. 


4.52.5 


INTEGRATION  OF  GAUSSIAN  DISTRIBUTION  ELECTRONS 


This  treatment  is  limited  to  the  energy  integral  of  the  Gaussian 
electron  distribution.  The  angular  dependence  has  been  integrated 
assuming  isotropy  as  discussed  in  Section  3.31  and  4.52.3.  From 
Section  3.31,  the  integral  of  interest  is 

OD 

(A)  Js  =  *B  f  Y(K)  exp[-(K-K0)2/62]k  dK  . 

J0 

As  in  the  previous  Sections  4.52.1  and  4.52.2,  the  inclusion  of 
the  angle  averaged  yield  function  Y(K)  will  make  0  the  current  of 
backscatter  or  secondary  electrons  (see  Section  3.33);  with  the 
omission  of  Y,  J  becomes  the  incoming  primary  flux. 

This  integral  is  performed  numerically  by  an  8  point  Hermit 
integration  scheme  (Ref:  Handbook  of  Mathematical  Functions,  U.  S. 
Dept,  of  Commerce,  National  Bureau  of  Standards,  Applied  Math  Series 
No.  55,  pp.  924,  1964). 


The  weights  and  absissa  are: 


i 

w(x.) 

1,5 

+0.38119 

6.61147  x  10'1 

2,6 

+1.15719 

2.07802  x  10"1 

3,7 

+1.98166 

CM 

\ 

O 

rH 

X 

00 

O 

• 

4,8 

+2.93064 

1.99604  x  10~4 

v>v  vv 


Equation  (4. 52.3— A)  can  thus  be  approximated  by 


(B)  J$  =  irB  ^  w*xi)  *  y(Ki)  *  exp[-&K^/fi2]  .  Ki  .  0(K KL ) 
i-1 

where 


Ki  *  Ko  +  Xi  *  5 
aK.  =  X.  *  6 


G(Ki  -.<)(=  1  for  K.  -  KL  >  0 
(  =  0  for  K.  -  KL  <  0. 


KL  is  chosen  as  max(0,  -qV)  which  excludes  energetically  trapped 
orbits. 


as  given  by  B  has  the  undesirable  property  of  being 
discontinuous  with  respect  to  K  due  to  the  0  function.  This 
feature  can  be  removed  by  calculating  J  with  the  same  scheme  (omitting 
Y).  J  will  be  discontinuous  at  exactly  the  same  values  of  K  as 
J^.  We  can  then  form  a  smooth  J,.  as 

* 

°S  =  T  ‘  °a 

where  is  the  analytic  solution  to  the  primary  flux  integral 
derived  below: 


K  -  K. 


Ja  =  qA  J  exp 


.J* —  tf-.m  —  - .  „  _  »  —  ^ j  —  _  .  m —a  ^  w’  .  w1  .  ji. 


set 


X  -  (K  -  K0)/« 


so 


Jfl  «  wB  f  exp(-X2)  (Xfi  +  KQ)  dX 

-7 


where 


Integrating 


^  fexpl-Z2) 


0  I  erf  (|  Z  |) 
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ION  SURFACE  CURRENTS 


For  the  attracted  ion  currents,  POLAR  tracks  particles  from  a 
sheath  surface  to  an  object  surface.  Experience  has  shown  that  if 
surface  currents  are  simply  accumulated  from  incident  particles,  the 
currents  are  noisy  and  lead  to  non-physical  charging  behavior. 

Numerous  reasons  exist  for  this  noise:  tracking  errors,  potential 
field  Irregularities,  too  few  trajectories,  etc.  While  these  problems 
have  all  been  studied,  it  remains  desirable  to  have  a  smoothing 
algorithm  for  the  v  .  surface  currents. 

The  ion  currents  to  be  smoothed  are  derived  from  the  "dead-list" 
of  particles  produced  from  the  particle  pushing  module  CURREN  (4.40). 
This  deed-list  contains  the  particle's  weight,  final  position,  final 
velocity,  and  initial  energy  and  the  surface  the  particle  landed  on. 

To  speed  up  the  surface  current  calculation  and  to  reduce  noise,  the 
dead-list  is  condensed  to  the  SRFC  list,  ordered  by  surface  number. 

The  particle  weights  are  added  since  they  represent  the  ion  current. 
The  particle  weights  are  also  used  to  weight  the  averages  of  spatial 
and  energy  information.  An  average  position  on  the  cell,  angle  of 
incidence,  and  particle  energy  are  calculated  as  follows: 


N 


E  »k 

ksl 


where  w.  is  the  weight  (current  contribution)  of  particle  k,  N  is 

K  XL 

the  number  of  particles  striking  the  surface,  and  is  the  i 
component  of  the  position  vector.  The  average  velocity  and  energy  are 
found  similarly. 


%  4 


The  adopted  smoothing  algorithm  Is  a  two-step  process  wherein 
the  raw  surface  currents  are  distributed  to  nodes,  and  then  re¬ 
distributed  back  to  surfaces.  This  simple  algorithm  Is  illustrated  in 
Figure  4.53/1.  Given  an  averaged  particle  at  the  point  P,  on  surface 
a,  its  current  is  shared  In  a  bilinear  fashion  to  the  vertices  (nodes) 
of  the  surface,  producing  a  node  current  1^. 


Since  two  different  types  of  surface  occur,  triangles  and 
rectangles,  two  different  methods  are  used.  For  triangles,  the 
bilinear  weight  of  a  corner  is  area  of  the  triangle  opposite  the 
corner  over  the  total  surface  area  (see  Figure  4.53/2). 
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sa 


wb 


sa 


_ area  a 

area  of  triangle  ABC 

* 

-  ■>  »  » 


(X-C)  x  (B-C)  1 


*  »  »  » 


|  ( A— C )  x  (B-C)  | 


where  w$n  is  the  bilinear  weight,  X  is 
the  particle  position,  and  s  and  a  refer 
to  surface  and  node. 


Figure  4.53/2.  Bilinear  weighting  of  triangular  surfaces 
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For  rectangular  surfaces,  the  particle  position  divides  the 
rectangle  into  four  smaller  rectangles.  Then  the  weight  is  found  by 
dividing  the  area  of  the  opposite  small  rectangle  by  the  area  of  the 
surface  (see  Figure  4.53/3). 


C  0 


Figure  4.53/3.  Bilinear  weight  (wb  )  of  a  rectangular  surface. 

So 

Thus  we  have  for  Figure  4.53/1 


aI.  -  wb  .  SRFC(a) 

I  Ml 

where  the  a  indicates  that  this  is  a  current  increment.  The  complete 
I .  is  never  formed. 

The  next  step  is  to  share  the  node  current  back  to  the 
surfaces.  We  may  derive  a  simple  sharing  formula  by  forming  a  nodal 
current  density,  aJ^  as 


where  the  are  areas  of  the  m  surface  cells  adjoining  node  i,  and 
nj  is  the  number  of  vertices  of  each  adjoining  surface  cell.  Ai 
is  bounded  by  the  dashed  line  in  Figure  4.53/1. 


The  aJ^  is  redistributed  to  surfaces  adjoining  node  i  in 
proportion  to  the  area  each  contributed  to  me  node  area.  Thus, 
surface  b  would  receive  a  final  surface  current  increment  Alk, 


Alh  *  7T  aJ, 
b  nb  i 


Finally,  we  may  combine  the  three  previous  equations  into  a  node 


to  surface  weight  factor  ws^-. 


Thus  the  final  surface  current, 


Alfa,  is  obtained  from  the  intermediate  node  current  aI..  as 


Al, 


wib  “b 


ws 


Abnb 


ib 


"i 


£  Vnj 

j*i 


This  process  is  performed  for  each  surface  adjoining  the  i  nodes 
of  surface  a.  The  final  smoothed  surface  currents  are  accumulated  as 
this  overall  process  is  repeated  for  all  the  surfaces  of  the  object. 


An  important  feature  of  this  algorithm  is  that  a  uniform  flux  to 
an  irregular  object  will  produce  surface  currents  exactly  proportional 
to  the  surface  areas  as  would  be  expected.  To  see  this,  consider  the 
quasisphere  of  Figure  4.53/1.  This  object  has  three  types  of 
surfaces,  with  areas  S,  R,  and  T;  and  only  one  type  of  node.  A 
uniform  flux  of  particles,  if  tracked  accurately,  will  produce  uniform 
node  currents.  Summing  w .  .  *  I.  around  the  vertices  of  a  surface, 

1 J  I 

we  see  that  the  resulting  surface  current  will  be  proportional  to  the 

surface  area,  and  inversely  proportional  to  the  factor  in  the 

denominator  of  the  expression  for  ws..,  which  is  constant  for  our 

J 

example.  The  ws^j  are  properly  normalized.  This  can  be  easily  seen 
in  our  example  by  summing  the  ws,.  around  a  node; 

'  J 


since  the  indices  k  and  j  range  over  the  same  surfaces. 

At  our  present  stage  of  development,  we  are  simply  dividing  and 
redistributing  the  node  currents  according  to  the  relative  areas  of 
adjacent  cell,  but  provisions  have  been  made  for  a  more  comprehensive 
treatment.  For  example,  spatial  and  electrical  information  could  be 
used  to  avoid  non-physical  sharing  of  surface  currents;  such  as 
redistributing  ion  currents  to  a  surface  with  a  large  positive 
potential,  or  around  corners. 
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5.  POLAR  CODE  STRUCTURE 


This  chapter  Is  designed  to  provide  Insight  Into  the  internal 
workings  of  POLAR.  Whenever  possible,  actual  subroutine  names  and 
variable  names  will  be  used. 

5.10  TOP  DOWN  VIEW 

POLAR  is  actually  five  s*  'ilone  programs  that  communicate 
through  a  minimum  number  of  fil  This  approach  allows  a  high  degree 
of  flexibility  in  model  building  while  minimizing  the  amount  of 
unnecessary  computing.  These  programs  are  VEHICL,  ORIENT,  NTERAK, 
SHONTL,  and  PLOTTR.  Their  functions  are  described  below.  Whenever 
scratch  files  are  used,  they  are  assigned  and  disposed  of 
automatically.  In  general,  only  two  files  are  needed  to  allow 
communication  between  the  four  modules. 

VEHICL  is  the  object  definition  program.  It  utilizes  much  of 
the  user-oriented  object  definition  procedures  developed  at  S-CUBED 
for  NASCAP.  With  VEHICL,  one  uses  a  variety  of  basic  building  blocks 
to  define  the  vehicle  to  be  modeled  on  a  variable  sized  3-D  grid.  One 
also  defines  all  of  the  surface  properties  and  underlying  conductors. 
VEHICL  then  completes  the  vehicle  electrical  model  and  creates  a 
number  of  "connect ivity“  tables  to  accelerate  NTERAK  execution.  This 
information  is  written  on  two  files,  11.  and  19.,  which  carry  this 
information  to  the  other  modules. 

ORIENT  is  the  attitude  control  program.  User  input  is  simply 
the  dominant  plasma  flow  direction  viewed  from  the  vehicle.  If 
necessary,  ORIENT  will  rotate  the  vehicle  and  object  grid  so  as  to 
keep  the  wake  direction  predominantly  in  the  +Z  direction.  ORIENT 
will  also  restructure  most  of  file  11  so  that  it  will  have  the  correct 
sliceability.  The  restructured  file  11.  contents  will  either  be 
copied  back  to  file  11.,  or  output  to  a  new  file  11S,  where  S 


represents  a  user-supplied  suffix.  A  set  of  six  11S  files  would 
catalog  all  of  the  possible  coordinate  orientations,  and  allow  for  all 
Mach  vectors. 

NTERAK  is  the  biggie  that  actually  calculates  the  vehicle-plasma 
interaction.  The  internal  workings  and  I/O  are  the  subject  of  most  of 
this  document,  but  it  should  be  emphasized  that  once  a  Mach  vector  has 
been  defined,  the  extended  computational  grid  will  be  "burned"  into 
the  11 S  file.  The  11S  maintains  a  complete  restart-continue 
capability,  but  a  fresh  file  must  be  used  if  the  Mach  vector  is  to  be 
changed. 


SHONTL  is  the  machine  independent  plotting  package.  It  is 
designed  to  be  run  semi-interacti vely.  By  this  we  mean  that  plotting 
directives  are  entered  by  a  "keyword"  input  system  that  function  in 
both  batch  arid  interactive  environments,  but  nothing  is  plotted  until 
the  session  is  concluded  and  PLOTTR  is  executed.  This  somewhat 
cumbersome  procedure  is  necessary  to  maintain  the  machine  independence 
of  SHONTL.  SHONTL  can  be  used  after  any  of  the  previous  three  modules 
to  graphically  check  the  work  progress  at  any  given  stage.  SHONTL 
reads  from  file  11,  and  communicates  with  PLOTTR  through  file  2. 

PLOTTR  is  the  machine-dependent  plotread  package  that  reads  the 
generic  pen-move  and  vector  commands  written  on  file  2  by  SHONTL,  and 
translates  these  commands  to  the  local  graphics  package. 


5.13  NTERAK 


The  program  NTERAK  is  the  heart  and  brain  of  POLAR.  It  contains 
all  of  the  physical  models  and  computational  techniques  described  in 
the  previous  chapters.  The  purpose  of  this  section  is  to  outline  the 
structure  of  NTERAK.  Further  descriptions  of  the  functional  content 
of  the  more  important  routines  can  be  found  in  the  indicated 
sections.  For  clarity,  utility  routines*  have  been  omitted  from  the 
following  chart: 

Level  1 

NTERAK:  Main  executive  routine 

Calls  INPUT 
SPACE 
PWASON 

Level  2 

INPUT:  Controls  the  keyword  input  of  options  and 

parameters  (6.40)  and  opens  files  9  and  11  (5.30). 
SPACE:  Set  up  the  computational  grid  (5.20). 

Calls  MRBUFF. 

PWASON:  Control  of  the  Poisson  iteration  and  tests  for 

convergence  (4.21.5). 

Calls  IONOEN 
Calls  CONGRD 
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Level  3 
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MRBUFF : 


IONDEN: 


CONGRD: 


loop  on 


Initializes  the  vector  properties  that  effect  their 
paging  from  core  to  disk. 

Controls  the  calculation  of  the  ion  densities 
(3.20,  4.40). 

Performs  the  conjugate  gradient  calculation  and 
tests  CGM  convergence  (4.21.1). 

Calls  COPROD 
URSETO 
i  COPROD 

PUTDAT 
RUPDAT 
UUPDAT 


Level  4 


COPROD:  Called  first  to  calculate  M  .  t  to  estimate  initial 

residuals,  r  (4.21.1)  and  to  calculate  the  linear 
screening  for  the  Poisson  iteration  (4.46). 


i  '  ■ 

VW 
■  >,■  - 


URSETO 

PUPDAT 

RUPDAT 

UUPDAT 


Loop  calls  calculate  M  .  U 
Calls  BUFCLR 


BUFSET 

PAGER 

CURCEL 

VERTIO 

ELEMNT 

DCVCEL 

FORFIL 

BACFIL 


XYGRID 


ZBNDRY 

YBNDRY 

XBNDRY 

GETSCR 

PCUBES 

ECUBES 


Calculate  r  .  r  and  initialize  u  (4.21.1). 
P  equation, 
r  equation, 
u  equation. 
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5.20  SLICE  GRID  SYSTEM 


The  displaced  slice  grid  system  is  designed  to  provide  the 
computational  space  in  which  to  solve  Poisson's  equation  for  the 
shuttle  orbiter,  including  a  wake  extending  many  spacecraft  lengths. 
Hence  the  grid  must  continue  for  an  arbitrary  length  in  the  plasma 
flow  direction. 

To  facilitate  this,  the  grid  is  composed  of  a  variable  number  of 
XY  slices,  stacked  along  the  Z  axis,  rather  like  a  loaf  of  sliced 
bread.  Figure  5.20/1  illustrates  a  displaced  grid  system  along  with  a 
number  of  important  parameters.  Objects  are  defined  on  a  rectangular 
NXOB  x  NYOB  x  NZOB  grid  (5.11,  6.20).  In  all  cases,  the  object  grid 
will  have  been  rotated  by  ORIENT  such  that  the  dominant  component  of 
the  plasma  flow  vector  VMACH  is  oriented  along  the  +Z  direction.  As 
shown  in  the  figure,  the  grid  follows  VMACH  by  stepping  +1  unit  in  the 
X  and  Y  direction  every  1DELX  and  1DELY  mesh  units  along  the  Z 
direction  (the  +1  step  follows  the  sign  of  1DELX  or  1DELY).  These 
step  intervals  are  calculated  in  the  routine  N. SPACE  according  to  the 
relation  (FORTRAN) 

IDELX  =  VMACH (Z) /VMACH(X)  +  0.5 

(y)  (y) 

where  the  +  follows  the  sign  of  VMACH(X).  Since  IDELX  is  an  integer, 
the  0.5  centers  the  velocity  ratio  between  integral  increments. 

The  computational  grid  must  enclose  the  object  grid  with  a 
minimal  amount  of  wasted  space.  To  accomplish  this,  the  routine  SPACE 
references  the  two  grids  at  the  point  shown  in  Figure  5.20/1,  then 
calculates  the  NXGRTH(NYGRTH)  necessary  to  fit  the  grids  together. 

When  the  user  anticipates  the  need  for  additional  work  space,  the 
INPUT  parameters  NXADON  and  NYADON  can  increase  the  X-Y  grids  without 
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Figure  5.20/1.  A  X-Z  cut  of  a  typical  NTERAK  computational  mesh 

showing  the  object  definition  grid  and  the  computed 
(NXGRTH,  IDELX)  and  user-specified  (NXADON,  NZADON, 
NZTAIL)  grid  parameters. 


requiring  a  redefinition  of  the  object  space.  The  GRTH  and  ADON 
parameters  are  included  into  the  final  NX  x  NY  dimensions. 


The  computational  space  is  characterized  by  the  following 
parameters: 


NXOB.NYOB.NZOB 


NX 


NY 

NZ 


The  real  node  dimension  of  the 
object  grid  along  the  X,  Y,  and  Z 
directions. 

NXOB  +  NXGRTH  +  2  x  NXADON 

the  real  node  dimension  of  a  slice 

along  the  X  direction. 

NYOB  +  NYGRTH  +  2  x  NYADON 
NZOB+NZTAIL  +  NZADON 


The  NZADON  and  NZTAIL  are  also  inputs  to  NTERAK  and  are 
currently  limited  to  total  a  Z  node  count  of  100.  This  limit  could  be 
extended  indefinitely  subject  to  available  disk  storage  and  budget 
limitations.  This  last  feature  is  the  intended  result  of  NTERAK's 
data  management  system.  This  system  allows  models  to  be  constructed 
primarily  on  disk  with  the  computer  "core"  used  to  perform  arithmetic 
on  small  volumes  of  space. 
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5.21  SLICE  MACHINERY 


5.2-4 


The  grid  machinery  consists  of  routines  designed  to  move  or  page 
grid  information  between  disk  and  core.  In  both  media,  information 
for  each  of  the  vectors  ('p'»  'r‘,  'u'»  etc.  (4.21.1)  are  called 
vectors  even  though  they  are  scalars  at  a  particular  grid  point) 
involved  in  a  calculation  Is  organized  into  individual  one-dimensional 
arrays  corresponding  to  each  X-Y  slice. 


/.V,  " 


NTERAK  distinguishes  between  two  types  of  nodes,  real  and 
virtual.  At  real  nodes  a  problem's  variables  are  truely  variables. 
Virtual  nodes  exist  as  the  outer  boundary  of  the  problem,  where  values 
are  generated  according  to  the  boundary  conditions.  There  may  be  one 
or  two  virtual  nodes  beyond  the  edge  of  a  slice  (see  Figure  5.20/1) 
depending  on  the  proximity  of  a  step.  Only  real  nodes  are  paged  in 
and  out.  Each  vector  slice  has  a  real  node  length  NX  x  NY  with  the 
assumed  convention  that  the  X  coordinate  varies  the  fastest. 

In  order  to  relate  the  slices  to  one  another  and  perform 
arithmetic  with  minimal  confusion,  it  is  necessary  to  adopt  a  standard 
coordinate  system.  There  are  two  possible  choices;  object  and  slice 
coordinates.  We  have  chosen  object  coordinates  as  the  primary  system, 
but  slice  coordinates  are  sometimes  required  by  lower  level  routines. 
Object  coordinates  reference  the  "least"  real  node  of  the  object  grid 
as  (1,1,1)  (see  Figure  5.20/1).  By  "least"  we  mean  the  node  for  which 
NX  x  NY  x  (Z-l)  +  NX  x  (Y-l)  +  X  is  a  minimum.  Thus  the  least  real 
node  object  coordinates  of  some  slices  may  be  less  than  zero,  while 
the  slice  coordinates  of  the  least  node  will  be  (1,1, ZSL ICE )  where 
ZSLICE  numbers  from  1  to  NZ.  The  relationship  of  the  slices  to  each 
other  is  written  in  the  common  block  MESHY  by  the  routine  GRID.  This 
block  contains  the  object  coordinates  of  the  least  real  node  of  each 
slice.  For  further  detail  concerning  subroutines  and  common  blocks 
see  Appendices  A  and  B. 
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NTERAK's  grid  machinery  exchanges  information  between  disk  and  a 
special  common  block  called  CBUF.  The  core  location  of  CBUF  is  such 
that  its  addresses  are  the  highest  of  all  other  data  and 
instructions.  On  many  machines  this  allows  the  CBUF  length  to  be 
extended  or  reduced  dynamically  during  execution  to  precisely  match 
storage  requirements.  The  allocation  and  addressing  of  data  space  in 
CBUF  is  controlled  by  three  routines  (see  Section  5.30),  MRBUFF, 
BUFCLR,  and  8UFSET.  MRBUFF  is  called  only  once  from  the  level  2 
routine  SPACE  and  initializes  the  array  VPROPS  which  contains  all  of 
the  individual  vector  properties  that  affect  the  vector's  handling 
storage  requirement  in  CBUF  and  on  disk. 

Subsequently,  any  computational  process  requiring  vector  slice 
transfers  to/from  disk  will  first  call  BUFCLR.  BUFCLR  clears  the 
ADORES  common  block  which  contains  the  CBUF  addresses,  releases  any 
dynamical  requested  core,  and  resets  other  storage  control  variables. 

The  next  step  is  to  call  the  routine  BUFSET,  passing  it  a  list 
of  up  to  four  vector  names  and  the  number  of  slices  that  will  be 
needed  in  core.  BUFSET  will  assign  each  vector  a  region  in  CBUF,  and 
list  this  addresse  in  the  common  ADORES.  BUFSET  may  be  called 
repeatedly  for  a  total  of  12  vectors.  For  example,  in  an  operation 
requiring  three  slices  of  ' R * ,  ' R 1  would  be  assigned  the  address 
sequence;  A,  B,  C,  A,  B,  C,  A,  B,  ...  ,  for  all  1-NZ  slices.  The 
actual  transfers  are  effected  by  PAGER,  which  can  read,  write,  or 
read-write  slices.  Suppose  that  2,  3  and  4  were  in  core  starting  at 
the  CBUF  address  B,  C  and  A,  respectively.  If  PAGER  were  called  to 
read-write  'R1,  for  slices  3-5,  ' R '  slice  2  at  B  would  be  written  on 
disk,  and  slice  5  would  be  read  into  CBUF  at  B.  The  R  slices  3  and  4 
would  remain  untouched. 
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Some  other  routines  that  are  commonly  used  with  this  grid 
machinery  should  be  mentioned.  One  is  XYGRID,  which  looks  in  the 
MESHY  common  block  and  returns  the  X  and  Y  limits  of  a  slice  in  object 
coordinates.  The  others  are  XBNDRY,  YBNDRY,  and  ZBNDRY.  These 
routines  will  take  an  element  index  (equal  to  the  least  index  of  its 
eight  nodes)  and  determine  which  of  the  element's  eight  nodes  are  real 
or  virtual  (boundary  nodes).  This  information  is  kept  in  the  array 
MBXYZ(8).  To  form  an  element  on  the  staggering  grid,  VERTIO  is  called 
to  pick  four  nodes  from  each  of  the  two  bordering  slices  totaling 
eight  vertices.  Individual  words  of  a  vector  at  a  node  are  located  in 
CBUF  by  the  statement  function  CBUFAO  (Appendix  B). 

In  retrieving  these  words,  the  MBXYZ  array  is  consulted  to 
determine  if  a  node  is  virtual.  If  so,  the  boundary  value  (currently 
zero)  will  be  used  for  that  node. 

The  routine  GETSCR  is  a  cousin  to  VERTIO.  It  will  'GET'  or 
'REP'  the  element  centered  quantities  *GI '  or  'SCRN'.  *GI '  is  the 
name  given  to  the  normalized  ion  densities  (3.20,  4.41),  and  'SCRN' 
refers  to  screening  factors  (4.43). 

For  further  details  concerning  the  function  or  use  of  this 
machinery,  the  individual  subroutine  description  in  Chapter  100  should 
be  consulted.  In  addition,  the  subroutine  COPROD  uses  all  of  this 
machinery  and  may  be  consulted  for  an  example. 


5.22  VOLUME  ELEMENT  MACHINERY 


To  Illustrate  NTERAK's  volume  element  machinery  we  will  describe 
its  use  by  the  subroutine  C0PR00.  COPROD's  function  is  to  generate 
the  M  •  U  product  and  U  •  M  •  U  inner  product  (4.30).  Once  slice 
information  has  been  accessed  and  resides  in  core  (5.21),  COPROD  must 
calculate  residuals,  element  by  element,  and  return  the  vector  so 
calculated  back  to  the  disk  in  slices.  These  operations  are  complex 
and  require  fairly  elaborate  machinery.  We  begin  by  offering  a  brief 
overview. 

COPROD  begins  by  reading  In  the  relevant  slice  information, 
establishing  a  section  of  the  computational  space  in  core.  This 
volume  is  swept,  element  by  element.  Each  element  is  characterized  by 
the  coordinates  of  its  lowest  indexed  vertex.  The  potentials,  and 
other  vector  information,  for  each  of  the  eight  vertices  of  a 
particular  element  are  extracted  from  the  main  /CUBF/  array  by 
VERTIO.  VERTIO  also  replaces  or  augments  array  entries  with 
calculated  vertex  information. 

The  potentials  at  the  boundary  of  the  computational  space  are 
assumed  to  be  fixed  and  known  (presently  set  to  zero).  Hence  they  are 
not  stored  explicitly  in  CBUF.  Instead,  COPROD  examines  each  vertex 
of  each  volume  element  and  determines  if  any  be  an  implicit  boundary. 
Those  that  do  are  fixed  at  the  boundary  potential.  VERTIO  (5.21, 
Appendix  B)  takes  the  X-Y  displacement  of  the  slices  into  account  in 
picking  out  the  vertices.  Having  set  the  potentials  at  the  vertices 
of  a  particular  element  with  VERTIO,  COPROD  calls  ELEMNT  to  look  up 
its  characteristics  in  the  list  ' LTBL ' .  LTBL  is  an  array  with  an 
entry  for  each  element  in  the  object  grid,  'LTBL'.  LTBL  is  an  array 
with  an  entry  for  each  element  in  the  object  grid,  containing  the 
following  bit  coded  information  (5.23):  the  element  type,  the  number 
of  surface  cells  sharing  one  or  more  nodes  with  the  element  (NCELLS), 
the  element  orientation,  and  the  top/bottom  flag. 
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The  number  of  surface  cells  (NCELLS)  sharing  nodes  with  the 
element  is  used  to  refer  to  a  second  list,  LCEL.  If  NCELLS  is 
non-zero,  OCVCEL  is  called  to  decode  the  next  (NCELLS  +  1)  entries  in 
the  LCEL  (5.25)  list.  The  first  word  of  this  group  will  be  an  element 
I.D.  number  used  merely  as  a  check.  The  remaining  words  are  also  bit 
coded  with:  the  surface  cell  number,  the  N00C0D  telling  which  nodes 
are  shared  with  the  surface,  and  the  FCN  number  (4.21)  telling  which 
element  face,  if  any,  the  surface  occupies. 

If  a  vertex  or  node  is  shared  by  a  surface  cell,  its  potential 
is  replaced  with  the  surface  potential  for  that  cell,  stored  in  the 
array  SVRFV,  sequentially  by  cell  number.  In  the  same  way  the 
contribution  to  the  residual  derived  from  the  shared  vertex  is 
returned  to  the  list  SVRFR  rather  than  the  residual  vector.  Hence  the 
surface  potentialsd  play  the  part  of  additional  grid  points,  or 
variables  in  the  matrix  conjugate  gradient  equations.  If  a  vertex  is 
shared  by  more  than  one  surface  cell,  the  adjoining  cell  potentials 
are  averaged  by  FORFIL  (4.21)  and  assigned  temporarily  to  the  vertex. 
Once  the  vertice  potentials  have  been  collected,  the  residuals  (4.30) 
are  calculated  by  either  PCUBES  or  ECU8ES  (4.20,  Appendix  B)  and 
shared  back  to  surface  cells  SRFR  entry. 


5.23  ELEMENT  TABLE,  LT8L 


The  element  table,  LTBL,  Is  a  list  with  one  entry  for  every 
element  in  the  grid.  An  element's  LTBL  entry  can  be  accessed  by 
calculating  its  relative  address  as  if  it  were  a  3-D  array  LTBL 
(X,Y,Z)  where  the  Z  range  starts  with  the  first  slice  in  core  (5.21). 

Each  word  is  coded  in  the  following  manner: 
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DC  BA 

where: 

A  -  The  element- type  number. 

B  -  The  number  of  surface  cells  sharing  nodes  with  the  element 
(up  to  15)  (NCELLS) . 


C  -  The  orientation  of  the  cell.  This  is  only  significant  for 
partially  filled  cells  and  is  explained  in  Reference  5-1. 

D  -  Top/Bottom  flag  for  elements  above  or  below  a  thin  plate. 


D  . 

1  -  bottom 

= 

2  -  top 

= 

3  -  both  top 

and  bottom,  type  5 

following  element 

types  are  allowed: 

Type  Number 

Bits 

Description 

0 

000 

Empty  cube 

1 

001 

Half-empty  wedge 

2 

010 

Cube  with  diagonal  on  one  face 

3 

Oil 

Tetrahedron 

4 

100 

Truncated  cube 

5 

101 

Empty  cell  bisected  by  a 

diagonal  thin  plate 

6 

110 

Unused 

7 

111 

Filled  cube 

These  volume  elements  are  described  in  4.21. 


5.2-12 


5.24.1 


SURFACE  CELL  LIST,  KSURF 


One  of  the  lists  produced  by  VEHICL  and  stored  on  file  11  (see 
Chapter  5.30  on  file  11)  is  the  surface  cell  list,  KSURF.  This  list 
consists  of  bit  packed  word  pairs  for  each  surface  cell.  The 
information  content  is  explained  below,  and  the  bit  coding  convention 
is  illustrated  in  Figure  5.24/1.  The  bit  ordering  notation  used  here 
assigns  each  bit  the  exponent  of  2  required  to  move  an  integer  1  to 
that  location  by  multiplication. 

COND  =  Conductor  number,  1  to  15. 

NORM  =  Surface  normal  in  Miller  indices,  two  bits  for  each 

index.  The  lowest  bit  representing  1  or  0,  and  the 
highest  set  for  minus,  off  for  plus. 

XI,YI,ZI  Lowest  coordinates  of  the  volume  element  with  which 

X0,Y0,Z0  =  the  surface  cell  is  associated  (the  element  that 

XI  ,YI  ,ZI  the  cell  normal  points  in  to). 

MAT  =  Material  number,  assigned  by  order  of  definition. 

B  =  Set  for  all  right-triangular  surface  cells 

(100,0-10,  etc.)  and  for  all  equilateral  (111) 
triangles  whose  enclosing  volume  element  is  mostly 
empty. 

H  =  Orientation  code  for  right-triangle  surface  cells. 

The  two  bits  define  the  location  of  the 
right-angled  corner  in  the  plane  of  the  triangle, 
i,  j.  The  greatest  bit  refers  to  j.  The  j  and  i 
are  related  tn  the  normal  direction  as  follows: 


(0  0  +1)  =  Z 


X0,Y0,Z0 


Volume  element  that  the  surface  normal  points  out 
of. 


1  -  bottom  surface  of  a  thin  plate 

2  -  top 
0  -  N/A 


The  KSURF  list  is  written  on  file  11  by  either  subroutine 
V. RESURF  or  0. RESURF.  Prior  to  output  it  is  ' Z '  ordered  to  produce 
sliceability  in  the  chosen  orientation.  It  is  written  on  11  in  a 
series  of  records  with  each  record  containing  all  the  word  pairs  with 
a  given  ZI  coordinate.  These  records  are  indexed  by  the  NWSURF(2) 
list  in  record  1  of  file  11.  For  each  ZI  of  the  object  grid  there  is 
a  NWSURF  entry  set  equal  to  the  number  of  KSURF  words  in  the  record 
for  that  ZI.  If  an  NWSURF  entry  is  zero,  ther  corresponding  null  2C 
record  of  KSURF  is  skipped. 
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5.25  LCEL,  CONNECTIVITY 

The  LCEL  list  is  used  in  the  potential  solving  segment  to 
connect  node  point  to  surface  cells  (4.20,  5.22).  This  is  a  bit 
packed  list  with  the  following  structure: 

ELT# 

CODED  WORD 
CPDED  WORD 


ELT# 


The  ELT#  is  a  coded  element  identifier, 

ELT#  -  4096  x  (I  +  64  *  J  +  4096  *  K) 
which  serves  as  a  check  for  correct  addressing  in  the  list. 

Addressing  is  accomplished  by  accumulating  the  NCELLS  word  count  from 
the  element  table  LTBL  (5.22,  5.23). 


The  coded  words  are  bit  packed  as  follows: 


Bits  0-7 

are  set  if  the  corresponding  vertex  is  shared 

with  the 

surface  cell.  The 

vertices 

are 

numbered  with  X 

changing 

faster  than  Y  which  changes 

faster  than  Z,  e.g. , 

for  element  1,  1,  1 

Coordinates 

Number 

X 

Y 

Z 

1 

1 

1 

1 

2 

2 

1 

1 

3 

1 

2 

1 

4 

2 

2 

1 

5 

1 

1 

2 

6 

2 

1 

2 

7 

1 

2 

2 

8 

2 

2 

2 

Is  the  standard  orientation 

surface 

node 

number  (see  4.21) 

that  the 

surface  will  have  when  forming  • 

the  element  into 

which  this  surface  points. 

Is  the  surface  number. 

Is  a  code 

:  for  surfaces  that 

are  on  the  top  or  bottom  of  a 

thin  plate  (4.21.1). 

5.30  FILE  SYSTEM 


One  of  the  most  outstanding  features  of  POLAR  is  its  file 
management  system.  This  system,  combined  with  the  sliced  grid  system 
(5.20)  allows  POLAR  to  model  variably  large  3-D  problems  (20,000  grid 
points  is  common),  with  fewer  than  100,000  words  of  core.  The  modules 
VEHICL,  ORIENT,  NTERAK,  and  SHONTL  communicate  through  the  mass 
storage  files  11  and  19  (see  5.31).  Internal  to  each  module,  other 
files  of  differing  types  are  used  as  scratch  files.  VEHICL  uses  the 
NASCAP  object  definition  coding  and  thus  a  variety  of  NASCAP  files  are 
used  initially  in  VEHICL  as  scratch  files.  This  document  will 
ultimately  describe  these  files,  but  the  reader  is  presently  referred 
to  Reference  1.  Two  files  (11  and  19)  are  used  instead  of  just  one,  so 
that  one  may  be  indexed  with  literal  name  keys  (19),  and  the  other 
(11),  with  number  type  index  keys. 


5.31  MASS  STORAGE  FILE  MANAGEMENT 


Data  stored  on  the  permanent  file  11  and  19,  and  the  scratch 
file  9  and  10,  is  written  and  retrieved  using  the  COC  MSIO  system 
(mass-storage-input-output).  On  non-CDC  machines,  the  MSIO  routines 
OPENMS,  WRITMS,  READMS,  and  CLOSMS  are  provided  by  POLAR  FORTRAN 
routines  which  mimic  the  COC  versions  to  provide  a  machine  independent 
interface  to  the  host  system.  We  now  describe  these  four  routines  as 
they  are  used  in  POLAR. 


OPENMS: 

Example: 

DIMENSION  IND  (NUM) 

CALL  OPENMS  (LUN,  IND,  NUM,  t) 

LUN  - 

The  logical  unit  number  of  the  file. 

IND  - 

Space  provided  for  a  working  copy  of  the  file  index. 

NUM  - 

Length  (words)  of  IND 

t  - 

type  of  index 

=  0,  number  type  index 
=  1,  name  type  index 

To  index  XR  records,  a  t  =  0  file  requires  NUM  >  XR  + 
for  t  =  1,  NUM  ^  2*XR  +  1. 

READMS: 

Example : 

DIMENSION  BUFR(IOOO) 

CALL  READMS  (LUN,  BUFR(IOO) , NWDS, KEY) 

LUN  - 

Logical  unit  number 

BUFR(IOO) 

-  Starting  address  to  which  data  is  to  be  read 

NWDS  - 

Number  of  words  to  be  read 

KEY  - 

The  index  key  under  which  the  data  record  was  stored. 

5.30  FILE  SYSTEM 


One  of  the  most  outstanding  features  of  POLAR  is  its  file 
management  system.  This  system,  combined  with  the  sliced  grid  system 
(5.20)  allows  POLAR  to  model  variably  large  3-D  problems  (20,000  grid 
points  is  common),  with  fewer  than  100,000  words  of  core.  The  modules 
VEHICL,  ORIENT,  NTERAK,  and  SHONTL  communicate  through  the  mass 
storage  files  11  and  19  (see  5.31).  Internal  to  each  module,  other 
files  of  differing  types  are  used  as  scratch  files.  VEHICL  uses  the 
NASCAP  object  definition  coding  and  thus  a  variety  of  NASCAP  files  are 
used  initially  in  VEHICL  as  scratch  files.  This  document  will 
ultimately  describe  these  files,  but  the  reader  is  presently  referred 
to  Reference  1.  Two  files  (11  and  19)  are  used  instead  of  just  one,  so 
that  one  may  be  indexed  with  literal  name  keys  (19),  and  the  other 
(11),  with  number  type  index  keys. 


5.31  MASS  STORAGE  FILE  MANAGEMENT 


Data  stored  on  the  permanent  file  11  and  19,  and  the  scratch 
file  9  and  10,  is  written  and  retrieved  using  the  CD C  MSIO  system 
(mass-storage-input-output).  On  non-CDC  machines,  the  MSIO  routines 
OPENMS,  WRITMS,  READMS,  and  CLOSMS  are  provided  by  POLAR  FORTRAN 
routines  which  mimic  the  CDC  versions  to  provide  a  machine  independent 
interface  to  the  host  system.  We  now  describe  these  four  routines  as 
they  are  used  in  POLAR. 

OPENMS: 

Example:  DIMENSION  IND  (NUM) 

CALL  OPENMS  (LUN,  IND,  NUM,  t) 

LUN  -  The  logical  unit  number  of  the  file. 

IND  -  Space  provided  for  a  working  copy  of  the  file  index. 

NUM  -  Length  (words)  of  IND 

t  -  type  of  index 

=  0,  number  type  index 
=  1,  name  type  index 

To  index  XR  records,  a  t  =  0  file  requires  NUM  >  XR  +  1; 
for  t  -  1,  NUM  >  2*XR  +  1. 

READMS: 

Example:  DIMENSION  BUFR(IOOO) 

CALL  READMS  (LUN,  BUFR( 100) ,NWDS,KEY ) 

LUN  -  Logical  unit  number 

BUFR(IOO)  -  Starting  address  to  which  data  is  to  be  read 
NWDS  -  Number  of  words  to  be  read 

KEY  -  The  index  key  under  which  the  data  record  was  stored. 


Example: 


CLOSMS: 

Example: 


CALL  WRITMS  (LUN,BUFR,NWDS,KEY ,r) 

LUN,  NWDS,  and  KEY  are  as  for  READMS;  data  is  read  from 
BUFR.  r  -  -1,  always  for  POLAR.  This  specifies  that  a 
record  may  be  overwritten  only  if  the  new  record  length 
does  not  exceed  the  old  length.  When  this  occurs,  a  new 
record  is  written  and  a  link  stored  in  the  old  location. 


CALL  CLOSMS  (LUN) 

This  routine  writes  the  working  index  from  core  to  the 
file  copy.  It  is  called  frequently  to  maintain  an  up  to 
date  file  copy  of  the  index  to  protect  data  against 
unexpected  crashes  and  stops. 


5.32  MRBUF  PLUS  BUFSET  PLUS  FRIENDS 

To  enhance  the  efficiency  of  both  the  execution  and  development 
of  POLAR,  a  formalized  system  of  variable  characterization  and 
identification  is  used.  This  begins  with  the  array  VPR0PS(20,70) 
wherein  20  different  properties  of  70  different  variables  are 
initialized  by  MRBUF.  To  set  up  a  work  space  for  a  variable  (or  a 
slice  of  a  variable)  in  the  general  purpose  buffer  CBUF,  a  call  is 
made  to  BUFSET  using  the  literal  name  of  a  variable  (5.33).  BUFSET 
will  move  the  vector  properties  from  VPROPS  to  a  working  array 
(1AVECS(20,I ) )  and  the  index  I  will  be  written  into  the  MELAD  common 
block  in  the  variable  pseudonym.  For  example 
CALL  BUFSET(5,  'POT',  ...) 

would  result  in  space  for  five  Z  slices  of  potential  to  be  allocated 
in  CBUF  with  all  essential  information  stored  in  IAVECS  (20,IP0T)  with 
IPOT  being  found  in  the  MELAD  common  block. 

The  IAVECS  properties  are  listed  below,  with  a  V  indicating  a 
non-variable  property  that  is  placed  in  VPROPS  by  MRBUF. 

V  I AVECS ( 1 , I )  =  Name 

I AVECS ( 2,1)  =  Start  address  in  CBUF 

I AV ECS (3,1)  =  Number  of  slices 

IAVECS(4,I)  =  Vector  length  of  a  slice 

I AVECS (5,1)  =  Words  per  vector 

(The  number  of  words  in  a  slice  is  IAVECS(4,I)  *  I AVE C S ( 5, 1 ) . ) 


V  IAVECS(6,I)  «  Mass  storage  file  number 

IAVECS(7,I)  «  Low  pointer  (shifted  slice  coordinates),  see 

property  14  and  Section  5.21 
and 

IAVECS(8,I)  «  High  pointer  used  by  the  data  paging  routine 

PAGER 

IAVECS(9,I)  «  Lower  (object  coordinates,  5.21) 

and 

IAVECS(IO.I)  «  Upper  object  limits,  inclusive 

IAV£CS(11,I)  =  Starting  key  number  for  the  number  key  files. 

V  I AVECS( 12 , I )  =  X  dimension  of  a  slice 

V  IAVECS(13,I)  «  Type  of  slice  or  vector.  Choices  are: 

*  VAR  I '  -  variable  length  (example,  LCEL) 
'SNGL'  -  single  slice  (example,  SRFV) 

'WORK'  -  work  space 
' OTHR '  -  other  (FOTO) 

1  -  object  slice  (LTBLO 

2  -  real  grid  (POT) 

3  -  outer  virtual  node  (LCOF) 

4  -  virtual  element  grid  (DION) 

V  IAVECS(14,I)  3  Shift  added  to  slice  coordinates  to  prevent 

FORTRAN  MOD  function  of  negative  or  zero 
slice  coordinates 

V  I AVECS (15,1)  »  Y  dimension  of  slJce 


IAVECS( 16, 1 )  = 


Lower  Z  limit  of  the  variable  range 


IAVECS{17, I )  = 


Pointer  to  relate  node  data  to  auxiliary 
node  data  {necessary  for  double  points 
created  by  thin  plates) 


IAVECS{18,I) 


Word  type,  'REAL',  ' INIT '  (integer),  'OCTL 


*  wH* 
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5.33  FiRBUF  VARIABLE  LIST 


KSURF 


DESCRIPTION  (See  Section) 


Element  table 

Surface  cell  list 

Surface  residual  list 

Surface  voltage  list 

Surface  to  node  connectivity  list 

Node  potentials 

Neutral  ion  densities 

Linearlized  screening  term 

Product  of  matrix  M  dot  U 
•>» 

Node  residuals 
Unused 

Congugate  gradient  error  vector 
Sheath  ion  densities 
Average  element  electric  field 
Element  location  with  respect  to  sheath. 

Also  a  calculation  saver  used  by  CURREN. 
Table  to  provide  direct  addressing  to  the 
LCEL  list  by  element  address 
Surface  V  list 
Surface  Y  list 

Velocity  space  map,  work  space 
Right  hand  side  of  charging  equation 
Total  surface  current  list  for  insulators 
and  conductor  list 

Small  surface  currents  for  insulators  and 
conductor  list 

Voltage  vector  used  to  construct  RHS 
(voltage  minus  conductor) 

List  indicating  surfaces  with  fixed  voltages 
in  insulator  plus  conduct  list  form 
The  capacitance  matrix  portion  of  charging 
equation 


-.'j 


NLST 


MRKR 

AMAT 

VDT 

SCRT 

CLRG 

CSMl. 

JPRM 

SGMA 

TSRV 

SREL 

SRFC 

SRFI 
TKSR 
SR  [A 
ASRF 
JFIX 
VXB 

SRDT 

EXTV 

JTSR 

JSMS 

SPAC 

IMAT 


A  list  of  insulating  surfaces 

Oefines  element  location  ICCG  packed  sparse 

matrix 

Marks  the  starts  of  new  rows  in  LIST 
A  work  space  used  for  calculating  RMAT 
Change  in  voltage  portion  of  charging 
equations  (the  answer  found  by  ICCG) 

Scratch  vectors 

Vector  list  of  large  capacitances  of 

insulating  surfaces 

Vector  list  of  small  capacitances  to 

insulating  surfaces  and  conductors 

List  per  surface  of  derivative  of  total 

current  by  surface  voltage 

Conductivity  matrix  including  grid  size 

Trial  surface  voltage  list 

List  of  pointers  per  surface  into  the  LCEL 

list 

Weighted  sums  of  particles  which  impacted  on 

object  during  CURREN 

List  of  surface  ion  currents 

Sets  C8UF  space  to  hold  all  KSURFs  at  once 

Estimate  of  ambient  ion  surface  current 

All  of  KSURF  in  C8UF,  unsliced 

Similar  to  I F I X  only  for  each  surface  cell 

V  cross  B  voltage  bias  for  each  insulating 

surface 

Keeps  the  voltage  of  fixed  surfaces 
Surface  voltages  found  during  first  trial 
step 

Total  current  to  each  surface 

Total  of  "small”  currents  to  each  surface 

Work  space 

Material  type  of  each  surface 


Conductor  number  of  each  surface 

Area  of  each  surface 

Voltage  from  previous  charge  step 

Composite  ion  density  array 

Memory  of  past  charge  information  (not 

implemented  yet) 

Code  history  information,  summary 

information  from  previous  PWASON,  CURREN  and 

CHARGE  cycles  (not  implemented  yet) 

Stabilized  charge  density  array 

Auxiliary  GI  values 

Auxiliary  DION  values 

Auxiliary  SCRN  values 

Auxiliary  QUSD  values 

Auxiliary  RHOI  values 

Coordinate  list  for  auliliary  values 

Pre  sigma  (conductance)  calculated  by  VEHICL 

and  DR  I  ENT.  Does  not  include  grid  size. 

Previous  CHARGE  cycle  total  surface  currents 

from  first  trial  step 

Surface  voltages  used  to  find  OLJT 


5.60  ION  DENSITIES 


The  calculation  of  ion  charge  densities  is  performed  in  two 
major  segments.  Before  any  electric  field  information  is  available 
the  straight  line  thermal  ion  density  is  calculated  everywhere  in  the 
grid.  When  potentials  have  been  calculated,  the  sheath  edge  is  found 
and  particles  are  tracked  from  the  sheath  edge  to  the  object.  The 
algorithms  for  these  two  calculations  are  described  in  the  following 
sections. 

5.61  PRESHEATH  IONS 

The  presheath  ion  density  calculation  consists  of  determining 
the  function  g(x,Sl)  and  described  in  Section  3.2.  This  function  has 
value  unity  when  particles  can  reach  point  x  from  angle  ft  without 
hitting  the  vehicle,  and  it  has  value  zero  when  the  particles  are 
prevented  from  reaching  x  because  they  are  blocked  by  the  object.  The 
major  routine  in  this  section  of  the  code  is  GEMFAC  for  geometrical 
factor,  and  the  results  used  by  NTERAK  are  GI's  for  geometrical  ions. 
The  GI's  are  element  centered  and  defined  as 


GI 


(I.J.K)-—-  /g(x,  ft  )  yfi0(r,v)v2  dx 


dft 


°i 


For  calculation  of  these  geometrical  factors  we  work  in  a  polar 
coordinate  system  whose  e  =  0,  t  =  0  ray  points  into  the  oncoming 
ions.  In  this  system,  the  function  fiQ  is  azimuthally  symmetric  and 
the  integral  is  reduced  to 


where  the  function  f(e)  is  normalized  so  that 


f^)  aei  Ai5i  =  1 


This  function  is  calculated  in  FCAL.  The  calculations  are  done  on  a 
uniform  grid  with  a  default  resolution  of  1*  in  e  and  10°  in  i>.  The 
greater  resolution  in  the  polar  angle  e  is  necessary  since  f  changes 
so  rapidly  as  we  move  away  from  the  ram  direction.  The  geometrical 
factor  is  calculated  by  taking  the  building  block  surfaces  (A2's  from 
HIDCEL)  and  projecting  them  onto  the  e,  i>  plane.  Regions  inside  of 
each  surface  are  then  marked  as  excluded.  The  major  source  of  error 
is  the  interpolation  between  vertices  in  e,  t>  space,  since  the 
straight  line  edges  in  Cartesian  space  are  not  straight  lines  in  e,  t> 
space.  To  improve  accuracy,  ADVERT  adds  extra  vertices  in  the  middle 
of  edges  for  each  A2  surface.  The  number  of  vertices  per  edge  is 
controlled  by  NADD,  and  has  default  value  of  2.  The  calculations  to 
determine  the  points  inside  the  surfaces  are  usually  done  in  STICK 
(for  STICK  a  one  into  the  GEM  array).  However,  the  cases  of  the  ram 
or  anti-ram  directions  being  excluded  must  be  treated  separately.  Th 
poles  in  the  e,  <b  space  are  singular  points  and  are  handled  in  STKUP 
and  STKDN  for  the  e  =  0  and  e  =  it  poles,  respectively. 

GEMFAC  is  called  for  each  surface  by  NEUDEN  (for  neutral 
approximation  density)  which  also  performs  the  angle  summations.  The 
principle  advantage  of  this  geometrical  technique  is  speed,  the  tens 
of  millions  of  g(e,tf)  needed  for  the  densities  at  each  grid  point  can 
be  calculated  in  just  a  few  minutes  of  computer  time.  A  few 
representative  plots  of  ram,  regular  and  anti-ram  polar  angle 
projections  are  shown  in  Figures  5.61/1-5.61/3. 
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SHEATH  IONS 


The  space  charge  density  of  ions  internal  to  the  sheath 
boundary,  and  currents  of  ions  to  the  vehicle  surface  must  be 
determined  by  particle  tracking.  The  concepts  involved  were  discussed 
in  Section  3.30  and  4.42.  This  section  documents  the  coding 
responsible  for  these  calculations,  but  a  brief  overview  is  in  order. 


External  to  the  sheath,  electric  fields  are  weak  enough  to  allow 
for  accurate  estimates  of  the  ion  flux  to  any  portion  of  the  sheath 
surface,  including  ram  effects.  Presuming  a  previous  Poisson 
calculation,  the  sheath  is  currently  defined  to  be  an  equipotential 
near  the  ambient  plasma  temperature  (this  is  an  input  parameter). 

Once  the  sheath  is  located,  it  is  divided  into  subareas.  These 
subareas  subsequently  become  'particles'  which  represent  flux  tubes  of 
constant  current,  rather  than  constant  charge.  This  current,  referred 
to  as  current  weights,  is  the  subarea  times  the  input  flux  density  of 
ions  (Section  4.42)  to  the  subarea.  The  actual  particle  tracking  is 
done  per  slice  (4.11)  with  the  particle  'pusher'  sweeping  the  grid 
alternately  in  the  +Z  (called  right)  and  -Z  (left)  direction. 
Trajectories  evolve  in  the  X  and  Y  coordinate  directions  until  they 
exit  a  slice  whereupon  the  trajectory  information  is  stored.  The 
trajectory  is  picked  up  in  the  next  slice  or  the  return  pass  of  the 
pusher.  Ultimately,  they  leave  the  problem  or  more  commonly,  hit  a 
surface  and  are  moved  to  a  'dead-particle'  list,  and  are  later 
processed  into  surface  currents. 


Throughout  all  of  this  pushing,  the  time  a  particle  spends  in  a 
volume  element  is  multiplied  by  its  current  to  determine  the  space 
charge  contribution  to  the  element. 
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5.62.10 


SHEATH  EDGE 


The  routine  STHCAL  finds  the  sheath  boundary,  divides  it  into 
"particles",  and  then  writes  sliced  lists  of  particles  onto  file  10. 
The  boundary  potential  was  calculated  by  a  routine  called  FNDBND. 
Currently,  FNDBND  finds  the  boundary  potential  by  asking  the  user  to 
supply  it.  Later,  this  routine  will  calculate  a  potential. 

Once  the  boundary  potential  is  known,  STHCAL  loops  through  all 
of  the  elements,  calling  SHEATH  to  check  each  element  to  see  if  it 
contains  the  sheath  potential.  If  part  of  a  boundary  passes  through  a 
cell,  it  divides  the  boundary  surface  into  triangular  particles.  The 
particles  are  defined  by  their  area  (in  grid  lengths  squared)  and  the 
location  of  their  centroid. 

Sometimes  SHEATH  finds  particles  which  cannot  exist.  For 
example,  in  large  objects  some  of  the  nodes  within  the  object  will 
have  potentials  of  zero.  If  the  surface  potential  is  higher  than  the 
sheath  potential,  SHEATH  will  think  it  found  part  of  the  sheath 
boundary  and  define  some  particles.  It  is  also  possible  to  find 
particles  which  would  have  had  to  come  from  a  non-source  region. 

These  particles  are  eliminated  by  backtracking  to  see  if  there  is  a 
surface  or  a  high  potential  region  which  would  have  blocked  the 
particle. 

Once  all  the  particles  in  a  z-slice  (4.11)  are  defined,  they  are 
written  into  file  10  with  their  area,  the  location  of  their  centroid, 
and  their  initial  velocity.  Presently,  the  initial  velocity  is 
defined  to  be  zero.  Then  the  particle  lists  are  stored  in  a  linked 
list  data  structure  (5.62.11)  in  chunks  of  100  or  fewer  particles. 


5.62.11 


THE  PARTICLE  LIST  STRUCTURE 


The  particle  list  is  kept  in  a  linked  list  data  structure.  An 
array  in  the  common  block  /LNKCOM/  contains  either  -1  or  the  key  of  a 
particle  list.  The  key  is  key  number  of  the  particle  list  in  file  10 
as  it  is  used  by  the  MSIO  package. 

To  find  the  key  of  the  first  particle  list  of  a  certain  z-slice, 
the  /LNKCOM/  array  LKPART(i)  (LKSCUR(i)  for  surface  currents)  is 
indexed  by  the  z-coordinate  of  the  slice  (4.11,  4.12).  The  rest  of 
particle  lists  for  a  given  z-coordinate  are  indexed  by  the  first  word 
from  the  preceding  list.  This  is  the  MSIO  key  of  the  next  slice. 

When  a  particle  list  does  not  have  another  list  following  it,  the  key 
it  holds  is  a  -1.  The  negative  one  is  a  flag  signalling  the  end  of  a 
linked  list. 

For  example,  if  our  problem  had  a  z-coordinate  which  varied  from 
0  to  6  and  200  particles  in  z-slice  0,  730  particles  in  slice  3  and 
1300  particles  in  slice  4,  file  10  would  be  similar  to  table 
5.62.11/1.  Since  the  order  in  which  the  particles  were  stored  affects 
the  actual  contents  of  the  table,  there  are  a  number  of  possible 
arrangements. 

In  the  table,  230  particles  of  the  z  =  3  slice  are  in  file  10  at 
key  1  and  500  are  at  key  5.  Since  next  key  is  -1  for  key  5,  we  know 
there  are  no  more  particles  in  this  slice. 

As  particles  are  moved  to  other  slices,  space  opens  up  in  the 
middle  of  the  file  (keys  3,  4  and  8  in  the  example).  To  conserve 
space  and  to  keep  the  file  packed,  the  emptied  keys  are  also  linked. 

So  when  a  new  particle  list  needs  to  be  stored  on  file  10,  an  emptied 
key  will  be  used  if  there  are  any  available.  The  key  of  the  first 
empty  location  is  stored  in  the  variable  10L0KY. 


To  store  the  surface  currents,  another  array  LKSCUR(i)  is  used 
to  hold  the  key  of  the  first  particle  list  for  each  z-slice.  The 
linked  lists  allow  the  surface  currents  to  use  the  empty  spaces  left 
by  the  particle  list  used  by  the  sheath  particle  tracking  section, 
which  helps  keep  the  file  packed. 


5.62.12 


PARTICLE  PUSHING  UNITS 


It  is  convenient  to  define  special  units  for  the  trajectory 
calculations.  The  time  is  in  units  of  the  ion  acoustic  period,  the 
distance  is  in  grid  lengths,  the  velocities  are  in  Mach  velocities, 
and  the  acceleration  is  unitless.  The  quantities  are  defined  by 

v  (ion  acoustic  speed) 
t(grid)  =  t(sec)  *  tr-Vr  T w  WVA,- T 


x(grid)  =  x(meters)/h(grid  length  in  meters) 


v(grid)  =  v(meters/sec)/vs(ion  acoustic  speed) 


a(grid)  =  QE  * 


Ey(electric  field  in  volts 
T  (ion  temperature  in  volts] 


where  the  ion  acoustic  speed  is 


v^  a  f  k-Boltzman,  T  °K,  m  -  kg. 


After  MOVPAR  moves  the  particle,  it  increments  RHOI  (space 
current)  by  the  current  of  the  particle  times  the  time  it  was  in  the 
cell. 
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5.62.20 


SHEATH  CURRENT 


The  routine  CURREN  controls  the  process  of  finding  the  sheath 
current  (see  Figure  5.62.20/1).  CURREN  calls  the  initialization  and 
exit  routines  CURPEP  and  CUEXIT,  respectively,  and  it  pushes  the 
particles  alternately  to  the  right  (+Z)  then  left  (-Z)  until  all  of 
the  particles  have  left  the  grid  or  hit  the  object.  The  variable, 
NPRTCL,  is  the  number  of  particles  left  which  have  not  been  pushed 
to  completion. 


Figure  5.62.20/1.  Structure  diagram  of  the  subroutine  CURREN. 


5.62.21 


CURPEP  (CURRENT  PREPARER) 


Called  by  CURREN,  CURPEP  initializes  the  particle  counters, 
opens  file  10  and  initializes  it  (5.62.11),  clears  CBUF  with  a  call 
to  the  routine  BUFCLR,  and  calls  STHCAL  to  find  the  initial  set  of 
particles. 

Once  the  initial  particle  lists  are  calculated,  CURPEP  resets 
CBUF  for  PUSHER  with  calls  to  BUFCLR  and  BUFSET.  Then  the  force 
table  (QE),  the  extended  element  table  (LTYP),  and  the  sheath 
current  table  (RHOI)  are  initialized  to  complete  the  routine.  To 
speed  up  the  calculations  in  XITCEL  (5.62.22),  the  force  table  (QE) 
contains  the  acceleration.  The  acceleration  is  equal  to  the 
negative  tril inear  electric  field  divided  by  the  temperature  in 
volts.  The  units  of  the  acceleration  are  grid  units  (see  5.62.12). 


5.62.22 


PUSHER  (PARTICLE  PUSHING) 


This  routine  pushes  all  the  particles  to  the  left  or  to  the 
right.  PUSHER  loops  through  all  of  the  particles  in  each  2-slice, 
pushing  particles  until  they  leave  that  slice.  The  particles  leaving 
in  the  forward  direction  are  pushed  again  in  the  next  slice  and  so  on 
when  a  particle's  path  intersects  an  object  face,  the  particle  is 
transferred  to  the  surface  current  list  (5.62-11)  and  counted  as  a 
dead  particle.  Particles  detected  leaving  the  computational  grid  are 
counted  and  removed  from  the  problem  (although  their  previous 
trajectory  information  remains). 

The  routine  which  PUSHER  calls  to  push  a  particle  through  a  cell 
is  named  PUSH. 


PUSH  decides  which  of  two  pushing  techniques  to  use  to  push  a 
particle  out  of  its  cell.  PUSH  checks  the  element  table  (5.23)  to  see 
if  the  element  is  next  to  the  object  or  in  a  partially  filled  cell 
(both  are  labeled  'NEAR'  in  the  LTYP  table  in  CBUF).  The  routine 
STPPSH  moves  particles  which  are  'NEAR'  the  object.  If  the  particle 
is  not  close  to  the  object,  PUSH  calls  XITCEL  (exit  cell)  to  find  the 
time  the  particle  needs  to  exit  the  cell,  and  MOVER  to  move  the 
particle  to  its  new  location. 


XITCEL  solves  the  following  six  quadratic  equations  for  the 
time,  tj.j,  required  for  the  trajectory  to  be  traced  from  an  entry 
coordinate  XQ •  to  an  exit  coordinate  X^: 


xjf  . 


01 


+  V  .t.. 

01  Jl 


*  i  ‘41 


i  -  X,  Y,  Z 
j  =  +,  - 


where  V  .  is  initial  velocity.  QE .  is  the  acceleration  calculated 
01  1 

from  the  electric  field  at  the  center  of  the  element.  The  smallest 
positive  real  t..  is  chosen  as  the  time  required  by  the  particle  to 

J  ' 

leave  the  cell.  See  Section  5.62.12  for  a  discussion  of  the  special 
units  used  for  the  particle  pushing. 


5.6-15 

MOVER  used  the  time  found  by  XITCEL  to  find  the  new  particle 
location.  First  it  calculates  the  new  position  and  velocity  using 

Xi  -  X*.  +  V^t  +  \  QE.t2 

Vi  =  V*.  ♦  QEit 

Then  it  shifts  the  particle  position  by  one  thousandth  of  the 
velocity,  moving  forward  along  the  exit  axis,  found  by  XITCEL,  and 
backwards  along  the  other  two.  This  is  necessary  because  the 
particle's  cell  number  is  referenced  by  taking  the  integer  portion  of 
the  particle  position.  If  a  particle  stopped  exactly  on  the  top  side 
of  element  (i,j,k)  as  it  moved  downward,  the  address  found  by 
truncation  would  be  (i,j,k+l).  To  prevent  this  form  of  faulty 
addressing,  the  particle  is  moved  off  of  the  cell  boundaries. 

Because  the  central  electric  field  is  used  for  the  entire 
element,  and  the  total  energy  may  drift  with  each  move,  MOVER 
renormalizes  the  velocity  vector  to  force  the  particle  to  conserve 
energy.  After  MOVER  pushes  the  particle  out  of  the  element,  PUSH 
increments  the  RHOI  (space  current  density)  by  the  time  spent  in  the 
cell  multiplied  by  the  area  of  the  particle. 

When  the  particle  gets  closer  to  the  object,  MOVER  can  no  longer 
be  used  since  the  particle  could  strike  an  object  surface  before  it 
left  the  cell.  To  push  particles  within  a  grid  length  of  the 
spacecraft,  PUSH  calls  STPPSH  (step  push).  STPPSH  checks  to  see  if 
the  particle  is  inside  a  filled  portion  of  an  element.  If  it  is,  the 
routine  finds  which  surface  it  passed  through  and  returns  to  PUSH.  If 
not,  STPPSH  calls  STPPAR  (step  particle)  which  moves  a  particle  for 
time  t.  Time  t  is  the  smaller  of  the  time  required  for  the  particle 
to  free  fall  or  move  at  a  constant  velocity  a  distance  of  one-tenth  of 
a  grid  length. 
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where  E  is  the  electric  field  at  the  particles  position,  e  is  the 
plasma  temperature  and  D  is  one-tenth  of  a  grid  length.  When  the  time 
step  has  been  computed,  the  particle  is  moved  to  X ^ ,  (i  =  x,y,z) 


1  ^i  2 

X.  =  X  .  +  V  .t  +  77r 
i  oi  oi  c  e 


vi  =  vtf.  +  (Ei/e)t 

After  the  particle  is  moved,  STPPSH  increments  the  RHOI  (space 
current  density)  by  the  current  weight  of  the  particle  times  the  time 
it  was  moved.  Then  checks  to  see  if  the  particle  left  the  cell  by 
counting  hGw  many  of  the  element  coordinates  of  the  new  position 
differ  from  the  old.  If  the  particle  did  not  leave  the  cell,  energy 
conservation  is  checked  and  the  velocity  is  renormalized  if  there  is 
more  than  a  +5  percent  error.  Then  the  particle  is  pushed  again. 

If  the  particle  did  leave  the  cell,  energy  conservation  and  the 
number  of  element  coordinates  which  have  changed  are  checked.  If  the 
number  is  greater  than  one  or  the  energy  is  off,  the  particle  is 
backed  up  until  only  one  element  boundary  is  crossed  and  the  energy  is 
right.  The  routine  that  does  this  is  called  MOVBAK  (move  back).  It 
is  important  to  keep  particles  from  crossing  more  than  one  boundary  at 
a  time,  since  it  is  possible  for  particles  to  miss  corners  of  objects. 

MOVBAK  backs  up  a  particle  by  finding  the  average  velocity  of  a 
particle  during  the  timestep  (vaye  =  (v^  +  v)/2)  then  solving  x  * 

+  v  t  for  t  on  all  of  the  sides  of  a  cube. 
t  ave 


Using  the 

smallest  positive  time  it  finds,  it  moves  the  particle  from  its 
*► 

original  point  to  x'. 
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MOVBAK  then  moves  the  particle  off  of  the  cell  boundary  by  shifting 
the  position  by  0.001  times  the  velocity  in  the  same  manner  as  MOVER 
did  previously. 

After  calling  MOVBAK,  STPPSH  checks  energy  conservation  again. 
After  renormalizing  the  velocity,  if  necessary,  and  incrementing  RHOI 
the  particle  is  checked  to  see  if  it  hit  a  surface  as  it  left  the 
element. 


5.62.23  CUEXIT  (CURRENT  EXIT  ROUTINE) 

This  routine  takes  care  of  the  exit  from  CURREN.  It  prints  a 
tally  of  what  happened  to  the  particles  from  SHEDGE  and  it  closes  fi 
10,  which  now  contains  the  surface  currents. 
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5.71  ION  SURFACE  CURRENTS 

The  ion  surface  currents  are  found  in  the  list,  SRFI.  This  list 
is  created  in  the  segment  headed  by  the  subroutine  IONCUR  from  the 
dead  particle  list  (dead-list)  created  by  the  CURREN  segment.  The 
upper  structure  of  this  segment  is  illustrated  in  Figure  5.71/1. 


Figure  5.71.1. 

The  creation  of  the  SRFI  list  occurs  in  two  main  steps;  step  1 
reduces  the  dead-list  to  an  intermediate  SRFC  list,  and  step  2 
redistributes  the  surface  currents  among  the  surfaces.  The 
justification  and  computational  techniques  for  these  steps  have  been 
discussed  in  Section  4.53. 

Step  1  is  controlled  from  IONCUR  and  performed  by  INICUR.  The 
dead-list  can  be  very  large  with  an  order  that  is  best  described  as 
chronological.  A  particular  surface  will  appear  as  often  as  it  is 
struck  by  a  particle.  To  speed  up  the  surface  current  calculation, 
and  to  reduce  the  noise  inherent  to  particle  pushing,  INICUR  reads 
through  the  dead-list  sequentially  and  simultaneously  accumulates  in 
the  SRFC  list  the  "average"  particle  (see  4.53)  for  each  surface. 


■  - _r»  . 


JAm K' *W  ••s'  C  • 


J  HI  I  III  I  *1  1  I  !)■_ 


5.7-2 

This  average  particle  has  the  sum  of  the  contributing  current  weights 
with  an  average  impact  location,  energy,  and  velocity.  These  averages 
are  weighted  by  the  current  weights  (4.53). 

Step  2  is  the  redistribution  or  sharing  of  the  "raw"  surface 
currents  in  the  SRFC  list.  This  is  done  to  further  reduce  the  "noise" 
in  the  raw  ion  surface  currents  (4.53).  Thus,  IONCUR  will  next  loop 
over  the  surfaces  in  SRFC  and  for  each  surface,  S,  call  SPIATR  to 
calculate  the  bilinear  weights,  SPW  (node),  which  are  used  to 
distribute  the  SRFC  current  to  the  vertices  of  the  surface.  These 
node  currents  are  to  be  shared  back  to  all  of  the  surfaces  adjoining 
each  node.  IONCUR  loops  over  the  surface  vertices  calling  GETWGT  to 
calculate  the  CRW  (node,  ns)  where  ns  indexes  neighboring  surfaces 
(4.53).  The  surf  ace-node- surf ace  connectivity  is  provided  by  the  LCEL 
list  (5.25).  Since  the  LCEL  list  is  designed  to  be  read  sequentially 
and  is  ordered  by  slice  and  element,  direct  access  to  the  needed 
section  of  LCEL  is  provided  by  an  index  list  SREL  (5.25). 

After  the  CRW  have  been  obtained  for  a  node,  SPREAD  is  called  to 
perform  the  summation; 

SRFI  (ns)  =  SRFI  (ns) 

♦  UNITS  *  CRW  (node,  ns)  *  SPW  (NODE)  *  SRFC  (S) 

where  ns  ranges  over  the  neighboring  surfaces  including  surface  S. 

UNITS  =  ECHRG  *  DXMESH2  *  FNORMI,  where  ECHRG  =  1.6  x  10~19  Coulombs 
and  DXMESH  is  the  length  of  a  mesh  unit  in  meters.  FNORMI  is  the 
unperturbed  Maxwellian  flux  density  against  which  the  current  weights  are 
calibrated; 


FNORMI  =  n.  VkT/2w  m. 

where,  in  MKS,  n.  is  the  ion  density,  k  is  Boltzmann's  constant,  T 
is  temperature  and  m.  is  the  ion  mass. 
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5.73  CHARGE  (SURFACE  CHARGING  CONTROL) 

CHARGE  is  the  entry  level  routine  into  the  surface  charging 
section  of  POLAR  (see  Figure  5.73/1).  It  initializes  the  charge  cycle 
by  reading  in  the  material  properties  and  calculating  the  plasma  to 
surface  (routine  MAKCSM)  and  surface  to  conductor  (MAKCLG) 
capacitances. 


v.v, 

v.v 

v.v 


Figure  5.73/1.  Structure  diagram  of  subroutine  CHARGE. 

After  the  initialization  routines  have  been  called,  CHARGE 
calculates  the  explicit  then  implicit  surface  potentials.  Presently, 
CHARGE  loops  on  the  SURCHG  sequence  by  the  fixed  input  number,  MAXITT; 
however,  a  convergence  test  will  be  placed  in  the  location  indicated 
by  the  empty  oval.  Upon  conclusion,  the  array  SURFV  contains  the  new 
surface  potential  which  is  stored  on  file  19. 
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The  computational  theory  for  the  charging  section  is  discussed 
in  Section  4.50. 
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5.73.1 


SURCHG  (SURFACE  CHARGER) 


SURCHG  calls  the  routines  needed  to  set  up  the  equation  to  be 
solved  and  finds  the  next  set  of  surface  voltages.  SURCHG  can  solve 
the  charging  equation  in  either  the  explicit  form  (Eq.  (5.73-1-1))  or 
the  implicit  form  (Eq.  (5.73.1-2)). 


It  I"' 3V/aIt“it 
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(5.73.1-2) 


Using  a  flag  sent  by  CHARGE,  SURCHG  chooses  which  form  of  the  charging 
equation  to  solve  (see  Figure  5.73.1/1).  When  solving  the  implicit 
charging  equation  (5.73.1-2),  the  SURCHG  assumes  an  explicit  solution 
had  been  found  previously. 


SURCHG  (FLAG) 


FLAG  'SXFUCir 
__  __ 


(EXPLICIT) 


(IMPLICIT) 


MAKOJ 


MATGEN  SURVLT 


SURSET 


1 

MAKV 

MAKKHS II 

J 

11 

Figure  5.73.1/1.  Structure  diagram  of  the  routine,  SURCHG. 
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SURCHG,  called  with  an  "explicit"  flag,  generates  a(MAKSGM) , 
V(t)  (MAKV) ,  and  I(t)  -  o  V{t)(MAKRHS) ,  then  calculates  V(t+at) 
explicitly.  When  an  implicit  flag  Is  received,  MAKDJ  is  called  to 
calculate  dl/dV.  MAKDJ  will  call  MAKJ  which  will  recall  the  current 
routine  (4.50,  5.70)  for  an  estimate  of  I(t+at)  using  the  explicit 
V(t+at). 

At  this  point,  both  charging  equations  can  be  treated  the  same 
way.  The  matrix. 


is  calculated  by  MATGEN  (using  dl/dV  *  0  for  the  explicit  case), 
setting  up  M  for  the  ICCG  call  by  SURVLT.  SURVLT  solves  Eq.  (5.73.1-3) 

M  &V  «  R  (5.73.1-3) 

where  R  is  the  vector  found  by  MAKRHS  and  &V  is  the  change  in  the 
surface  potential. 

Using  the  &V  found  by  SURVLT,  SURSET  calculates  the  new  surface 
potentials  and  saves  them,  completing  the  charging  timestep.  The 
following  sections  discuss  the  above  routines  in  more  detail. 


5.73.2 


CHARGING  MATRIX  AND  VECTOR  FORMULATION 


As  discussed  in  Section  4.51,  there  are  two  cases  which  affect 
the  charging  equations,  5.73.1-1  and  5.73.1-2,  depending  on  the 
occurrence  or  non-occurrence  of  fixed  potential  surfaces.  When  a 
surface  potential  is  fixed,  the  matrices  and  vectors  of  5.73.1-2  are 
constructed  exactly  as  implied.  If  a  surface  has  been  fixed  by  CBRAIN 
(called  from  SURCHG)  SURCHG  passes  a  flag,  IFIXED,  to  the  matrix  and 
vector  routines  (MATGEN,  MAKRHS,  MAKJ,  MAKDP,  MAKV)  to  construct  the 
more  diagonalized  matrices,  C  and  a,  and  the  corresponding  vectors  V 
and  I.  These  transformations  are  discussed  in  4.51,  but  they  are 
characterized  by  constructing  V(t)  from  the  potential  difference 
between  a  surface  and  the  underlying  conductor  instead  of  simply  the 
surface  potential.  The  effect  of  this  is  to  reduce  the  off-diagonal 
elements  and  increase  the  diagonal  elements  of  the  amalgamated  matrix 
M  (Eq.  (5.73.1-3)).  ICCG  likes  this  and  will  generally  converge 
faster. 

Since  there  can  be  as  many  as  1200  surfaces  or  so,  it  was 
necessary  to  pack  all  the  matrices  in  the  problem  (unpacked  it  could 
be  1  million  words/matrix).  Since  the  matrices  are  mostly  empty,  just 
saving  the  nonzero  entries  and  their  locations  simplifies  the  problem 
greatly.  The  entry  locations  are  stored  in  a  list  (called  'LIST'  in 
MRBUF)  with  a  second  list  ('MRKR')  being  used  to  indicate  the  location 
of  rows  in  LIST.  The  entry  locations  are  stored  row  by  row  with  the 
first  entry  for  a  row  being  the  negative  row  number.  For  example,  the 
nonzero  locations  in  the  following  matrix 
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would  appear  in  LIST  as  -1,  -2,  3,  -3,  2,  4,  5,  -4,  2,  3,  5,  -5,  3,  4 
and  MRKR  would  be  1,  2,  4,  8,  12,  10000  with  the  10000  signalling  the 
end.  Since  the  matrices  always  have  nonzero  diagonals,  the  -2  in  LIST 
means  there  is  an  entry  at  (2,  2).  The  3  following  it  means  (2,3)  and 
so  on.  For  large  problems  this  greatly  reduces  the  data 
requirements. 


MAKSGM  (MAKE  THE  a  MATRIX) 

*S 

MAKSGM  makes  the  c  matrix  by  taking  conductivity  information 
created  by  VEHICL  and  moving  it  to  the  right  place  in  the  appropriate 
matrix  form  (see  5.72.2)  for  ICCG. 

MAKV  (MAKE  THE  VOLTAGE  VECTOR) 

MAKV  builds  the  voltage  vector  in  the  appropriate  form  (5.72.2) 
using  a  surface  voltage  list  and  the  conductor  voltage  common  block. 
The  LAD  number  of  the  desired  surface  voltage  list  is  passed  as  an 
argument  to  this  routine. 

MAKRHS  (MAKE  THE  RIGHT  HAND  SIDE) 

MAKRHS  makes  the  right  hand  side  of  the  vector  equation  solved 
by  ICCG.  The  right  hand  side  is  equal  to 

RHS  =  I.  -  o  V  . 

~z - 

This  is  done  by  first  calling  MAKJ  to  calculate  the  current  vector. 
Then  MAKRHS  finds  the  product  of  aV  and  subtracts  it  from  the 
current.  The  right  hand  side  of  the  vector  equation  is  the  same  for 
both  the  explicit  and  implicit  formulations  so  it  only  needs  to  be 
called  once  for  the  explicit  step.  Then  the  implicit  step  will  just 
use  the  RHS  found  during  the  explicit  calculation. 


MAKJ  (MAKE  THE  CURRENT  VECTORS) 


This  routine  finds  the  current  vector  I,  in  the  appropriate  form 
(see  5.72.2),  given  a  list  of  surfaces  voltages.  To  find  the 
contributions  to  the  current  from  the  various  sources,  MAKJ  calls  the 
routines  which  calculate  the  incident,  secondary,  and  backscattered 
electron  fluxes  and  the  incident  and  secondary  ion  currents. 

Two  lists  are  created  by  MAKJ,  one  is  the  total  current,  I.  The 
other  is  the  sum  of  the  secondary  currents,  I$m.  The  secondaries 
will  be  used  in  the  future  to  locate  surfaces  which  will  need  to  be 
fixed. 

MAKDJ  (MAKE  THE  dl/dV  MATRIX) 

MAKDJ  is  called  before  the  solution  of  the  implicit  equation  to 
create  the  dl/dV  matrix.  To  find  dl/dV,  MAKDJ  uses 


The  surface  voltages  at  t+at  were  found  during  the  explicit  step.  The 
surface  currents  at  t+at  are  found  by  calling  MAKJ  and  giving  it  the 
voltages  calculated  by  the  explicit  step. 

To  correct  for  the  explicit  charging  equations  tendency  to 
overcharge,  a  limit  is  placed  on  the  change  in  voltage.  During  the 
keyword  input  phase,  the  variable  ' DVLI M ’  is  set  and  this  is  the 
voltage  change  limit.  Thus,  for  a  surface  i,  V^t+at)  can  be  written 
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where  | aV ^  |  is  the  lesser  of  the  explicity  change  or  DVLIM.  The 
limited  voltage  is  then  used  to  find  the  new  surface  current.  The 
limited  surface  voltages  at  t+At  are  also  sent  to  MAKV  to  put  in  the 
appropriate  form  (see  5.73.2). 


Once  I(t+At)  and  V(t+At)  have  been  calculated,  dl/dV  is 
calculated  for  each  vector  entry.  If  the  value  is  not  negative,  dl/dV 
is  set  equal  to  a  zero  for  that  vector  entry.  This  is  done  to  prevent 
the  destabilizing  effect  of  a  positive  current  derivative  in  an 
element  on  the  matrix  diagonal  (see  3.41).  And  since  surface  to 
surface  interactions  are  not  being  dealt  with  presently,  there  are 
only  diagonal  elements  in  the  dl/dV  matrix. 

MATGEN  (MATRIX  GENERATION) 

MATGEN  finds  the  sum  of  the  matrices  which  multiply  the  voltage 
vector,  aV,  solved  for  by  ICCG.  It  performs  the  sum 
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SURVIT  (SURFACE  VOLTAGE) 

SURVLT  recovers  from  storage  on  file  19,  the  M  matrix  and  RHS 
vector  for  use  by  ICCG.  It  also  calls  ICCG  (4.32)  which  returns  aV. 
Currently,  the  initial  guess  for  aV  is  aV  =  0.  Also,  we  are  presently 
fixing  the  main  conductor,  or  spacecraft  ground.  The  ground  charges 
only  according  to  its  capacitance  to  the  plasma  which  is  small.  All 
other  surfaces  and  conductors  have  larger  capacitance  directly  or 
indirectly  to  the  ground  (see  Appendix  A,  and  Section  4.51).  Thus, 
fixing  the  ground  simplifies  the  checkout  of  the  charging  algorithms. 
This  restriction  will  be  removed  at  the  appropriate  time. 
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SURSET  (SURFACE  VOLTAGE  RESET) 

SURSET  uses  the  solution  found  by  SURVLT  to  find  the  new  surface 
and  conductor  voltages  after  charging. 
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5.82  GRAPHICAL  COOE  STRUCTURE 

5.82.10  AN  OVERVIEW  OF  SHONTL 

SHONTL  is  a  module  designed  to  create  the  graphics  commands  for 
PL0TR0.  It  presents  cross-sections  of  data  generated  by  NTERAK  as 
contour  plots.  Currently,  axial  slices  of  the  positive  ion  density, 
the  electric  field  potential,  the  sheath  boundary,  and  the  particle 
trajectories  can  be  plotted. 

The  form  of  the  plots  can  be  varied  by  using  keyword  commands. 
The  plot  types  and  slice  locations  are  also  defined  by  keywords.  The 
keywords  and  their  use  are  described  in  Section  6.5. 

5.82.11  SHONTL 

This  is  the  main  routine  of  the  module.  SHONTL  oversees  the 
order  of  operations  of  the  various  phases  of  the  plotting  process  (see 
Figure  5.82.11/1).  It  calls  an  initialization  routine  (PLINIT),  an 
exit  routine  (PI.EXIT)  and  cycles  on  the  input  routine  and  the  plotting 
routine  (PLINPT  and  GENPLT,  respectively).  EOF  is  a  flag  from  PLINPT 
signalling  the  end  of  a  plotting  session. 

5.82.12  PLINIT  (PLOT  INITIALIZATION) 

PLINIT  is  the  initialization  routine.  It  opens  POLAR  data  files 
11  and  19,  sets  the  raster  graphics  window,  initializes  common  blocks, 
sets  the  defaults  for  plot  descriptions  and  prints  a  welcoming  message 
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PLINPT  (PLOT  INPUT) 


This  routine  is  the  keyword  input  section  of  SHONTL.  PLINPT 
recognizes  the  various  keywords  (described  in  detail  in  Section  6.5) 
and  sets  the  appropriate  flag  for  GENPLT.  In  addition  to  keywords  for 
plotting  features  and  to  describe  the  data  for  plotting,  keywords  are 
also  recognized  which  direct  the  data  handling,  control  the  SHONTL 
exiting  and  plotting  procedure,  and  provide  useful  aids  for  the  user. 
These  include  a  'HELP'  command  which  provides  a  short  manual  for 
successful  plot  production,  a  ' DICT '  command  to  call  a  routine  to 
provide  a  complete  dictionary  of  keywords  and  a  'WHAT'  command  to  see 
which  plotting  features  have  been  selected. 

Additionally,  soon  there  will  be  a  'PROMPT*  command  which  will 
shift  the  input  mode  to  a  prompt  input  mode.  This  will  be  instructive 
the  first  few  times  SHONTL  is  used  since  it  steps  through  the 
available  features  in  sequence,  describing  each  briefly. 

All  of  the  plotting  features  have  default  values  set  in  PLINPT 
so  that  no  harm  will  be  done  if  a  flag  is  not  set  in  PLINPT  (the 
default  values  are  described  in  Section  6.5  also). 

5.82.14  GENPLT  (GENERATE  PLOTS) 

GENPLT  calls  the  routines  responsible  for  generating  the 
pseudo-graphics  calls  used  by  PLOTRO.  The  flags  set  by  PLINIT  and 
PLINPT  are  used  to  decide  which  plotting  routines  to  call. 

To  make  a  plot,  GENPLT  sets  the  constants  it  will  need,  reads 
the  data  to  be  plotted,  generates  the  plot  along  with  any  extra 
features  selected,  and  then  prepares  for  the  next  plot. 
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PLEXIT  (PLOT  EXIT) 


PLEXIT  is  the  exit  routine  for  SHONTL.  It  calls  PLOTRO  if  plots 
were  created  and  are  to  be  printed. 
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REFERENCE,  CHAPTER  5 

"NASCAP  Programmers'  Reference  Manual,"  S-CUBED  Report 
SSS-R-82-5443  (DRAFT),  March  1982. 
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6.0  OPERATING  INSTRUCTIONS 


In  general,  POLAR  can  be  run  in  either  an  interactive  or  batch 
computing  environment  using  keyword  input.  Commands  controlling  run 
characteristics,  defining  environmental  constants,  and  choosing  the 
amount  of  appropriate  output  are  either  recognized  by  the  module’s 
input  routine  or  by  a  general  input  routine  (POLINP)  which  processes 
non-module  specific  keywords  such  as  the  grid  size  and  diagnostic 
keywords. 

The  exception  to  this  general  rule  is  the  set  of  keywords  used 
to  define  an  object.  These  keywords  are  expected  to  be  found  within  a 
definition  file  separate  from  the  VEHICL  runstream.  Section  6.1 
describes  the  intricacies  of  object  definition  in  detail  and  includes 
several  helpful  examples. 

The  other  sections  describe  the  keywords  pertinent  to  all  of  the 
modules  (Section  6.7)  or  keywords  appropriate  to  a  particular  module 
(Sections  6.2  to  6.5).  Some  keywords  appear  in  several  locations  for 
the  sake  of  convenience. 


6.10  OBJECTS 


POLAR  objects  are  defined  separately  from  the  VEHICL  runstream. 
VEHICL  will  look  for  the  object  definition  file  as  unit  20  (CYBER)  or 
as  PREOBJ.  on  UNIVAC  with  PRE  being  a  prefix  given  in  the  VEHICL 
runstream  (Section  6.2). 

POLAR  objects  are  defined  in  an  object  grid  of  variable 
proportions  subject  to  the  limitation  NX*NY*NZ  =  9537; 

NY, NX  <_  32;  NZ  <  33.  The  keyin  language  is  identical  to  NASCAP, 
except  for  the  addition  of  slanted  thin  plates  and  the  omission  of 
booms  (POLAR  does  not  do  booms),  antennas,  and  thin  triangular 
plates.  If  "empty  space"  and  "object"  both  coexist  in  the  same 
computational  space  what  makes  objects  distinguishable  ?  The  answer  is 
that  POLAR  can  distinguish  between  volume  elements  that  are  filled 
(with  object)  and  those  that  are  empty  (except  tor  ambient  plasma  of 
course).  Once  we  have  this  distinction  it  is  easy  to  see  how  objects 
can  be  constructed  by  filling  in  collections  of  volume  elements.  For 
example,  a  sample  cuboid  may  be  constructed  by  filling  in  2  x  3  x  4  = 
24  elements  as  shown  in  Figure  6/1. 

While  arrangements  of  completely  filled  and  completely  empty 
cubes  can  be  quite  versatile  in  representing  objects  of  many  different 
shapes,  more  sophisticated  representations  are  possible  if  we  allow 
cubes  to  be  partially  filled  (or  partially  empty).  Only  three 
partially  filled  cubes  are  allowed.  These  are  shown  in  Figure  6/2. 

While  it  is  easy  to  see  how  objects  might  be  constructed  by 
filling  or  partially  filling  individual  volume  elements,  a  command 
structure  that  required  the  user  to  specify  every  element  comprising 
an  object  would  be  very  cumbersome  to  use.  So  several  generalized 
objects  are  definable. 

It  is  very  important  to  note  that  POLAR  objects  must  never  touch 
the  edge  of  the  object  grid  defined  by  VEHICL  (see  Section  6.2). 


Figure  6/2.  Four  shapes  of  volume  cells  considered  by  the  POLAR  CODE: 

(a)  empty  cube;  (b)  wedge-shaped  cell  with  110  surface; 
(c)  tetrahedron  with  111  surface;  (d)  truncated  cube  with 
111  surface. 


6.10.10  BUILDING  BLOCKS 


To  greatly  simplify  the  user  definition  of  objects,  POLAR 
pre-defines  commonly  used  shapes  built  up  from  individual  elements. 
These  shapes  are  called  POLAR  BUILDING  BLOCKS.  There  are  eight. 

Flat  Plate 
Slanted  Plate 
Cuboid 
Octagon 
Quasi  sphere 
Tetrahedron 
Wedge 
F I LI 11 

These  are  shown  in  Figure  6/3.  These  basic  shapes  can  be  defined  to 
be  any  size  (within  the  inner  grid).  POLAR  automatically  includes  the 
correct  number  of  individual  elements  for  the  size  of  building  block 
chosen  by  the  user. 

6.10.11  COMMANDS  (OR  HOW  DO  I  ACTUALLY  DEFINE  AN  OBJECT?) 

The  POLAR  module  VEHICL  is  responsible  for  recognizing  and 
understanding  the  object  defined  by  the  user  in  the  object  definition 
file. 


Each  bui lding  block  has  its  own  keyword.  For  example,  the 
quasi-sphere  is  associated  with  the  word  QSPHERE,  and  the  cuboid 
(rectangular  parallelepiped)  with  the  word  RECTAN.  The  building 
blocks  and  their  keywords  are  summarized  in  Table  6/1. 

Once  VEHICL  has  read  a  building  block  keyword  from  the  object 
definition  file,  it  then  expects  to  find  several  more  lines  (or  cards) 
setting  the  block  parameters.  These  might  include  the  dimensions  of 


Figure  6/3.  The  eight  building  block  types  are  shown  here.  The 
uppermost  object  shows  a  FILlll  smoothing  a  corner. 
Below,  from  left  to  right  are  quasi-sphere,  octagon 
right  cylinder,  tetrahedron,  wedge,  and  rectangular 


paral lelepiped. 


TABLE  6/1.  POLAR  BUILDING  BLOCKS  AND  THEIR  KEYWORDS 


Keyword 

Building  Block  Description 

FIL111 

Smooth  inside  of  a  diagonal  corner 

OCTAGON 

Right  octagonal  cylinder 

PATCHR 

Surface  of  a  rectangle 

PATCHW 

Diagonal  face  of  a  wedge 

PLATE 

Arbitrarily  triin  plate  or  cuboid 

QSPHERE 

Quasi  sphere 

RECTAN 

Cuboid  or  rectangular  parallelepiped 

SLANT 

Thin  plate  slanted  at  45° 

TETRAH 

Tetrahedron 

WEDGE 

Wedge  derived  from  half  a  cube 

-'4 


the  building  block,  its  orientation  and  the  materials  that  cover  its 
surface.  (Surface  materials  are  discussed  in  Chapter  6.12.)  Finally, 
VEHICL  expects  to  find  a  line  'ENDOBJ*  telling  it  that  no  more 
information  referring  to  the  present  block  is  coming  and  to  expect  the 
next  building  block  keyword.  The  information  to  be  entered  in  the 
object  definition  file  for  each  building  block  is  summarized  in  Table 
6/2.  Note  that  numbers  and  words  may  be  separated  by  one  or  more 
spaces  on  the  same  line.  (Input  is  free-format. ) 

The  keyword  'ENDSAT'  signals  the  end  of  the  satellite  definition 
and  should  be  included  at  the  end  of  all  vehicle  descriptions. 

6.10.12  PLATES  AND  PATCHES 

A  careful  inspection  of  Table  6/1  will  show  that  there  are  some 
building  blocks  that  are  not  derived  from  cubic  volume  elements. 

These  are  the  PLATE,  SLANT,  PATCHR  and  PATCHW. 

PLATES  are  arbitrarily  thin  cuboids  (RECTANS).  They  are  assumed 
to  have  only  a  top  and  a  bottom,  the  sides  being  of  negligible 
height.  Flat  plates  always  lie  in  one  of  the  axis  planes  (XY,  XZ, 

YZ).  SLANTed  plates  lie  along  one  axis,  and  at  a  45°  angle  to  the 
other  two. 

PATCHR  and  PATCHW  are  the  surfaces  only  of  a  cuboid  and  wedge, 
respectively.  They  are  used  to  change  the  surface  material  patterns 
of  existing  building  blocks  and  should  never  be  defined  in  spaces  not 
already  occupied  by  solid  objects.  (Objects  defined  to  occupy  the 
same  space  are  explained  in  Section  6.14.) 


TABLE  6/2.  OBJECT  DEFINITION  -  FILE  20 


6.1-8 


OBJECT  DEFINITION  OBJECT  DEFINITION  OBJECT  DEFINITION  OBJECT  DEFINITION 

SYNTAX  EXAMPLES  SYNTAX  EXAMPLES 


RECTAN 

CORNER  *  y  z 

DELTAS  Ay  AZ 

(UP  TO  6  SURFACE  CARDS) 

ENOOBJ 


WEDGE 

CORNER 

FACE  maienainame  normal 
(type  110) 

LENGTH  ax  Av  AZ 

(UP  TO  4  SURFACE  CARDS) 

ENOOBJ 


tetrah 
CORNER i y  z 
FACE  matenamame  normal 
(type  lit) 

LENGTH  ax 

(UP  TO  3  SURFACE  CARDS) 
ENOOBJ 


OCTAGON 
AXIS  x  y  Z  x  y' t 
WIOTH  w 
SIDE  S 

(up  to  3  special  surface 

CARDS 
Or  "C ') 

ENOOBJ 


RECTAN 

CORNER  3-28 
DELTAS  t  2  4 
SURFACE  +X  ALUMINUM 
SURFACE  -X  ALUMINUM 
SURFACE  +  Y  ALUMINUM 
SURFACE  -Y  aluminum 
surface  *z  aluminum 

SURFACE  -Z  ALUMINUM 
ENOOBJ 

WEDGE 

CORNER  -321 
FACE  SI02  -  t  -  i  0 
LENGTH  1  1  3 
SURFACE  +X  SI02 
SURFACE  +Y  SI02 
SURFACE  +  Z  GOLD 
SURFACE  -Z  SI02 
endobj 


tetrah 

OORNER  -3-2  8 
FACE  KAPTON  11-1 
LENGTH  2 

SURFACE  -X  TEFLON 
SURFACE  -Y  KAPTON 
SURFACE  +Z  TEFLON 
ENDOBJ 

OCTAGON 

AXIS  3.  2.-6  3.2  -9 
WIDTH  3 
SIDE  1 

SURFACE  +  SILVER 
SURFACE  -  SILVER 
SURFACE  C  MAGNES 
ENDOBJ 


Fil  ill 

CORNERLINE  x  y  z  x  y  z‘ 
FACE  maienainame  normal 
Hype  in) 

ENDOBJ 

PLATE 

CORNER  «  y  Z 
DELTAS  ax  Ay  AZ 

TOP  *g)  matenamame 

BOTTOM  2  (5)  matenamame 
ENDOBJ  'I/ 

PATCHR 

CORNER  x  y  z 

DELTAS  Ax  AV  AZ 

(UP  TO  6  SURFACE  CARDS) 

ENDOBJ 

PATCHW 
CORNER  x  y  z 
FACE  matenamame  normal 
(type  110) 

LENGTH  ax  Ay  AZ 

(UP  TO  4  SURFACE  CARDS) 

ENOOBJ 


FlLItt 

CORNER  3  2  6  -5  4  6 
FACE  SOLAR  -  1  -  1  -  1 
ENOOBJ 


PLATE 

CORNER  - t  -  i  -  10 
DELTAS  220 
TOP  ♦  Z  CPAINT 
BOTTOM  -Z  CPAINT 
ENDOBj 


PATCHR 

CORNER  3-28 
DELTAS  t  0  1 
SURFACE  -Y  SCREEN 
ENDOBJ 

PATCHW 

CORNER  -  3  2? 

face  aouadg  - 1  -  i  o 
length  i  i  i 
ENDOBJ 


NOTES  normal'  is  Itiree  values 
eacfi  either  +  1  0  or  -  1 
SURFACE  CARD  has  the  following  format 
SURFACE  matenamame 


SPECIAL  SURFACE  CARD  is 
surface  (e)  matenamame 


QSPHERE 
CENTER  x  y  z 
DIAMETER  d 
SIDE  s 

MATERIAL  maienainame 
-ENOOBJ 

SLANT 

CORNER  x  y  z 
TOP  materialnonaal 
(type  110) 
BOTTOM  material 
LENGTH  Ax  Ay  Az 
ENDOBJ 


OSPHERE 
CENTER  000 
DIAMETER  4 
SIDE  2 

MATERIAL  npaint 
ENDOBJ 

SLANT 

CORNER  -1-10 
TOP  TEFLON  110 

BOTTOM  KAPTON 
LENGTH  223 
ENDOBJ 


OTHER  OBJECT  DEFINITION  COMMANDS 

ENDSAT  Must  Be  last  card  m  fne 

COMMENT  No  effect 

OFFSET  i )  k  Moves  coordinate  ongm 

CONDUCTOR  n  Sets  numoer  ot  underlying  conoucior 

DELETE  1 1  k  Deieies  surfaces  leaving  empty  ceil 

unrecognized  word  Assumed  :o  oe  name  oi  new  surface 
material  Next  card  scanned  tor 
parameters 


6.10.13  SPECIAL  SHAPES 


FIL111  is  a  special  shape  designed  to  fill  in  "steps"  whose 
corner  line  runs  at  45*  to  the  grid  lines  in  any  axis  plane  (i.e.,  XY, 
ZY,  XZ)  (Figure  6/4a).  There  are  two  kind  of  "steps"  that  can  occur 
between  POLAR  building  blocks.  For  example,  a  small  cuboid  on  top  of 
another  creates  four  "steps"  that  lie  along  grid  lines  (Figure  6/4b). 
These  may  be  "filled  in"  or  smoothed  by  defining  a  WEDGE  to  lie  along 
the  corner  line  of  the  step.  A  second  type  of  step  is  possible 
however  when,  for  example,  a  tetrahedron  or  octagon  is  defined  to  sit 
on  top  of  another  building  block.  These  steps  have  corner  lines  that 
run  at  45°  between  grid  lines.  This  is  shown  in  Figure  6/4c.  Such 
steps  can  be  smoothed  or  filled  in  by  a  combination  of  tetrahedra  and 
truncated  cubes.  This  combination  is  supplied  as  the  building  block 
FILlll . 

6.10.14  BUILDING  BLOCK  PARAMETERS  (OR  WHO'S  ON  NEXT?) 

The  very  center  of  the  object  grid  is  assumed  to  be  the  origin 
of  the  coordinate  system  0,  0,  0.  Hence  the  grid  itself  extends  from 
-8  to  +8  in  the  X  and  Y  directions  and  from  -16  to  +16  in  the  Z 
direction.  This  coordinate  system  is  used  to  specify  the  position  and 
size  of  the  building  blocks  in  the  parameter  "cards"  or  lines 
following  the  building  block  keyword.  Let  us  examine  the  definition 
of  each  building  block  in  detail  to  see  how  this  works. 


vw 


ER  x  y  z 
AS  ax.  Ay,  az 
ACE  +X  GOLD 
ACE  -Y  KAPTON 

r  more  SURFACE  cards  for  -X,  +Y,  +Z,  -Z) 


is  the  building  block  keyword. 

y  z:  defines  the  coordinate  of  the  lowest  indexed 
the  cuboid  (the  one  so  that  if  you  added  up  x  +  y 
give  the  lowest  (least  positive)  number). 

,  Ay,  az:  gives  the  length  of  sides  of  the  cuboid 
X,  Y  and  Z  axes.  (Note  that  the  edges  of  the  cub 
in  the  direction  of  the  three  axes.) 


6.1-12 


As  an  example,  the  following  cards: 


RECTAN 

CORNER 

-4 

2  - 

OELTAS 

3 

2 

SURFACE 

+X 

GOLD 

SURFACE 

+Y 

GOLD 

SURFACE 

+Z 

GOLD 

SURFACE 

-X 

GOLD 

SURFACE 

-Y 

GOLD 

SURFACE 

ENDOBJ 

-Z 

GOLD 

define  a  gold  bar  extending  from  -4  to  -1  in  the  X  direction,  2  to  4 
in  the  Y  direction  and  -1  to  +4  in  the  Z  direction  (Figure  6/5). 


.-•-V  • 
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6.10.16  PATCHR 


PATCHR  is  defined  in  exactly  the  same  way  as  RECTAN. 

PATCHR 

CORNER  x  y  z 
DELTAS  ax  ay  az 

<SURFACE  card(s)  (usually  just  one)> 

<e.g.,  SURFACE  +X  GOLD 
(ENOOBJ 

PATCHR  should  only  be  defined  within  an  existing  object. (see  6.14). 
6.10.17  WEDGE 


The  following  cards  define  a  right  angled  wedge: 
WEDGE 

CORNER  x  y  z 

FACE  KAPTON  1  1  0 

LENGTH  ax  ay  az 

(  SURFACE  +X  TEFLON 

I  <Up  to  four  SURFACE  cards> 

ENDOBJ 


Notes: 

1.  WEDGE:  is  the  building  block  keyword. 

2.  CORNER  x  y  z:  defines  the  lowest  indexed  vertex  of  the  right 
angled  corner  of  the  wedge  (see  note  2,  6.10.15). 

3.  FACE  KAPTON  110:  contains  two  pieces  of  information: 

a.  'KAPTON'  assigns  the  material  KAPTON  to  the  surface  of  the 
face  of  the  wedge.  (The  face  is  the  sloping  surface  of  the 
wedge. ) 

b.  '1  1  0’  defines  the  direction  of  the  normal  to  the  face  and 
hence  the  orientation  of  the  wedge  itself.  The  normal  may  point 
in  any  of  the  following  directions  only: 


(For  those  of  you  not  familiar  with  the  *1  1  0‘  notation  a 
'1  1  O'  normal  is  a  vector  pointing  to  the  coordinates  X  =  1, 

Y  «  1  and  Z  »  0  from  the  origin.) 

4.  LENGTH  ax,  ay,  az:  gives  the  lengths  of  the  sides  of  the  wedge 
parallel  to  the  X,  Y  and  Z  axes.  To  maintain  symmetry  two  of 
these  must  be  equal  ( i . e . ,  the  two  right  triangle  sides). 

5.  SURFACE  +X  TEFLON:  assigns  the  material  'TEFLON'  (Section 
6.12)  to  the  surface  whose  normal  points  in  the  positive  X 
direction.  There  are  up  to  four  remaining  surfaces  that  may  be 
assigned  materials  (see  6.10.15,  note  4).  These  all  have 
normals  pointing  along  one  of  the  axis  directions.  Along  which 
axis  direction  they  point  depends  on  the  orientation  of  the 
wedge  or  the  choice  of  normal  for  the  face  (note  2).  The 
possible  combinations  of  face  directions  and  remaining  surface 
directions  are  summarized  in  Table  6/3.  Cards  defining 
materials  for  non-existent  faces  are  ignored. 

As  an  example,  the  following  cards: 


WEDGE 

CORNER 

0  0 

0 

FACE 

GOLD  1  1  0 

LENGTH 

2  2 

2 

SURFACE 

-X 

GOLD 

SURFACE 

-Y 

GOLD 

SURFACE 

+Z 

GOLD 

SURFACE 

-Z 

GOLD 

ENDOBJ 

define  a  wedge  covered  in  gold  with  the  origin  as  one  of  its  corners 
and  a  face  whose  normal  points  between  the  X  and  Y  axes  in  the  XY 
plane.  This  is  shown  in  Figure  6/6. 


i 


m 

v-v-3 

.  N  ,  » 


6.1-15 


TABLE  6/3.  DIRECTIONS  OF  SURFACE  NORMALS  ASSOCIATED  WITH 
ALLOWED  WEDGE  ORIENTATION 


Normal  of  WEDGE  Face 
1  1  0 
-1  1  0 
1  -1  0 
-1  -1  0 
1  0  1 
-1  0  1 
1  0  -1 
-1  0  -1 
0  1  1 
0  -1  1 
0  1  -1 
0  -1  -1 


Normals  of  Four  Remaining  Surfaces 
-X,  -Y,  Z,  -Z 
X,  -Y,  Z,  -Z 
-X,  Y,  Z,  -Z 
X,  Y,  Z,  -Z 
-X,  Y,  -Y,  -Z 
X,  Y,  -Y,  -Z 
-X,  Y,  -Y,  Z 
X,  Y,  -Y,  Z 
X,  -X,  -Y,  -Z 
X,  -X,  Y,  -Z 
X,  -X,  -Y,  Z 
X,  -X,  -Y,  -Z 
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6.10.18  PATCHW 


PATCHW  is  defined  in  exactly  the  same  way  as  a  wedge. 

PATCHW 

CORNER  x  y  z 
FACE  GOLD  1  -1  0 

LENGTH  ax  ay  a z 

<Up  to  four  SURFACE  cards  (usually  just  orie)> 

ENDOBJ 

Like  PATCHR  (6.10.16)  it  may  only  be  used  to  define  a  wedge  inside 
another  building  block.  This  is  explained  further  in  Section  6.14. 

6.10.19  TETRAH 


The  following  cards  define  a  tetrahedron: 


TETRAH 

CORNER 

X 

y  z 

FACE  ALUMNUM  1 

LENGTH  ax 

SURFACE 

-X 

TEFLON 

SURFACE 

-Y 

TEFLON 

SURFACE 

ENDOBJ 

+Z 

TEFLON 

Notes: 

1.  TETRAH  is  the  building  block  keyword. 

2.  CORNER  x  y  z:  defines  the  coordinates  of  the  right  angleo 
corner  of  the  tetrahedron.  There  is  only  one  of  these.  (It 
corresponds  to  the  corner  of  the  partially  filled  cubic  volume 
element  that  is  actually  filled.) 

3.  FACE  1  1  -1:  assigns  the  material  ALUHINUN  to  the  unique 

face  of  the  tetrahedron  opposite  the  right  angled  corner. 

'1  1  -1'  gives  the  direction  of  this  face's  surface  normal  and 

hence  the  orientation  of  the  tetrahedron.  The  following 
directions  only  are  allowed: 

+1,  11,  11 

(This  notation  is  the  same  as  explained  in  6.10.17,  note  3.) 
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LENGTH  ax:  gives  the  length  of  the  sides  along  the  X,  Y  and  Z 
axis  directions.  (These  must  all  be  equal  to  preserve  symmetry.) 

SURFACE  -X  TEFLON:  assigns  the  material  teflon  to  the 
remaining  surface  with  surface  normal  pointing  along  the 
negative  X  axis  direction.  Up  to  three  surfaces  remain  to  be 
assigned  materials  (see  6.10.15,  note  2).  The  surface  normals 
of  these  surfaces  depend  on  the  orientation  of  the  tetrahedron 
and  hence  the  normal  of  the  "face".  Table  6/4  summarizes  these 
relationships.  Definitions  of  non-existent  surfaces  are  ignored. 


TABLE  6/4.  DIRECTIONS  OF  SURFACE  NORMALS  ASSOCIATED  WITH 
ALLOWED  TETRAHEDRON  ORIENTATIONS 


Normal  of  TETRAHedron  Face 


1  1  1 


Normals  of  Three  Remaining  Surfaces 


-X,  -Y,  -Z 


-1  1  1 

1  -1  1 

1  1  -1 


-1  -1  1 


-1  1  -1 

1  -1  -1 

-1  -1  -1 


X,  -Y,  -Z 
-X,  Y,  -Z 
-X,  -Y,  Z 
X,  Y,  -Z 
X,  -Y,  Z 
-X,  Y,  Z 
X,  Y,  Z 
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As  an  example,  the  following  cards: 

TETRAH 

CORNER  000 
FACE  KAPTON  1  1  1 

LENGTH  2 

SURFACE  KAPTON  -X 
SURFACE  KAPTON  -Y 
SURFACE  KAPTON  -Z 
ENDOBJ 

define  a  tetrahedron  with  its  right  angle  corner  at  the  origin  and  the 
normal  of  the  opposite  face  pointing  between  the  positive  X,  Y  and  Z 
axes.  This  is  shown  in  Figure  6/7. 

6.10.20  OCTAGON 

The  following  cards  define  a  right  octagonal  cylinder: 

OCTAGON 

AXIS  x  y  z  x '  y '  Z ' 

WIDTH  w 
SIDE  s 

SURFACE  +  GOLD 
SURFACE  -  GOLD 
SURFACE  C  GOLD 
ENDOBJ 

Notes: 

1.  OCTAGON:  is  the  building  block  keyword. 

AXIS  x  y  z  x '  y 1  z':  defines  both  the  direction  of  the 
symmetry  axis  and  the  height  of  the  cylinder.  The  symmetry  axis 
must  be  parallel  to  one  of  the  axis  directions.  Thus  two  of  the 
coordinate  pairs  (x,  x'),  (y,  y ' )  and  (z,  z')  must  be 
identical.  For  example. 


o 

L  . 


would  define  an  axis  that  was  not  parallel  to  the  X,  Y  or  Z 
directions.  However, 

'AXIS  6  3-2  12-2' 

defines  an  axis  parallel  to  the  X  direction  and  is  acceptable. 

The  height  of  the  cylinder  is  given  by  the  difference  in 
coordinates  along  the  axis  direction.  (For  example,  in  the  case 
above,  the  axis  is  one  mesh  unit  long.) 

3.  WIDTH  w:  gives  the  width  of  the  octagonal  cross-section  of  the 
cylinder  as  w.  If  WIDTH  is  chosen  to  be  odd,  the  axis  must  be 
moved  or  the  sides  of  the  cylinder  will  lie  halfway  across  a 
volume  element.  POLAR  automatical ly  moves  the  axis  +l/2  a  mesh 
unit  in  each  direction  in  the  plane  perpendicular  to  it. 

4.  SIDE  s:  gives  the  length  of  one  of  the  sides  of  the  octagonal 
cross-section  that  lies  in  an  axis  direction.  The  symmetry 
relationship  between  the  width  and  the  ides  of  the 
cross-section  is  shown  in  Figure  6/8.  To  maintain  this 
relationship  the  side  must  always  be  an  even  number  of  mesh 
units  less  than  the  width.  This  means  that  they  both  either 
must  be  odd  or  both  even  numbers  of  mesh  units. 

5.  SURFACE  +  GOLD:  assigns  the  material  GOLD  to  the  top  surface  of 

the  cylinder.  and  'C'  replacing  the  ,+'  assign  surface 

materials  to  the  bottom  or  side  cylindrical  surface, 
respectively.  Only  those  surfaces  that  will  eventually  become 
surfaces  of  the  completed  object  need  be  assigned  a  material. 

As  an  example,  the  following  cards: 

OCTAGON 

AXIS  2-46  2  -4  10 

WIDTH  5 
SIDE  3 

SURFACE  +  TEFLON 
SURFACE  -  TEFLON 
SURFACE  C  TEFLON 
END08J 

defines  a  right  octagonal  cylinder  covered  in  teflon.  The  symmetry 
axis  lies  along  the  Z  direction  and  the  height  of  the  cylinder  is  four 
mesh  units.  Because  the  WIDTH  is  odd  the  axis  is  imagined  to  pass 
through  the  point  2  1/2,  -3  1/2  in  the  X  Y  plane.  Hence  the  top  and 


bottom  faces  run  from  X  =  0  to  X  =  5  and  from  Y  =  -6  to  Y  =  -1.  The 
coordinates  of  the  top  of  the  cylinder  are  shown  in  Figure  6/8.  A 
three-dimensional  view  is  shown  in  Figure  6.9. 


Figure  6/8.  Top  of  an  OCTAGON. 
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6.10.21  OSPHERE 


The  following  cards  define  a  quasisphere: 
QSPHERE 

CENTER  x  y  z 
DIAMETER  d 
SIDE  s 

MATERIAL  Si 02 
ENDOBJ 


Notes: 

1.  QSPHERE:  is  the  building  block  keyword. 

2.  CENTER  x  y  z:  defines  the  center  of  the  sphere  to  be  at 
coordinates  X,  Y,  Z. 

3.  DIAMETER  d:  defines  the  diameter  of  the  sphere  to  be  d  mesh 
units.  The  quasisphere  can  be  thought  of  as  an  octagonal 
cross-section  (like  the  top  of  an  OCTAGON  (see  6.10.20))  rotated 
about  an  axis  in  the  cross-section  plane.  The  diameter  then 
corresponds  to  the  UIDTH  for  a  two-dimensional  octagonal 
section.  The  same  restrictions  then  apply:  An  oad  value  for 
the  DIAMETER  causes  POLAR  to  automatically  move  the  CENTER  by 
+1/2  a  mesh  unit  in  the  X,  Y  and  Z  directions. 

4.  SIDE  s:  sets  the  length  of  a  side  lying  in  one  of  the  axis 
planes  (e.g.,  X  Y  plane).  Like  the  OCTAGON,  the  SIDE  and 
DIAMETER  must  differ  by  an  even  number  of  mesh  units. 

5.  MATERIAL  SI02:  assigns  the  material  SI02  to  the  whole  sphere 
surface. 

As  an  example,  the  following  cards: 

QSPHERE 

CENTER  1  -3  5 

DIAMETER  7 
SICE  3 

MATERIAL  SILVER 
ENDOBJ 
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6.10 .22  FIL111 


The  following  cards  define  a  FILlll: 
FIL111 

CORNERLINE  x  y  z  x'  y'  z' 
FACE  KAPTON  1  -1  -1 
ENDOBJ 


Notes: 


FILlll:  is  the  building  block  keyword. 

CORNERLINE  x  y  z  x'  y'  z':  defines  both  the  length  and  the 
direction  of  the  "step"  FILlll  is  to  fill.  The  line  must  lie  in 
one  of  the  axis  planes  (XY,  XZ,  YZ)  and  must  have  a  direction 
lying  45°  to  two  of  the  axes.  This  means  that  one  pair  of  the 
coordinates  (x1,  x),  (y,  y')  (z,  z')  must  be  identical  and  the 
other  two  pairs  must  differ  by  the  same  magnitude.  For  example, 

'CORNERLINE  123  456' 

is  unacceptable  since  all  three  coordinate  pairs  change.  The 
following  correct  example 

'CORNERLINE  123  -143' 

defines  a  line  in  the  XY  plane  (Z  is  constant)  with  ax  =  -2,  and 
Ay  =  +2.  Hence  the  line  is  2/7  units  in  length  and  runs  at  45° 
between  the  positive  Y  axis  and  the  negative  X  axis. 

FACE  KAPTON  1  -1  -1:  assigns  the  material  KAPTON  to  the 

exposed  surfaces  of  the  FILlll  and  defines  its  orientation  via 
the  surface  normal  of  its  exposed  face:  1  -1  -1.  The  surface 

normal  can  only  be  combinations  of 

+1  !l  l1 

Only  certain  choices  of  corner  line  direction  are  consistent 
with  each  choice  of  FACE  normal.  If  we  subtract  the  x  y  z, 
x'  y'  z'  coordinates  defined  in  corner  line 

ax  =  x'  -  x 
Ay  =  y'  -  y 
az  =  z'  -  z 

then  the  surface  normal  n^  n^  03  (e.g..  Ill)  must  be 
orthogonal  to  ax,  Ay,  az,  i.e., 

^x  •  nj  +  .  n2  +  aZ  •  n3  _  0. 


A 

m 


6.1-27 


With  the  choice  123  -143  for  the  corner  line 

coordinates  only  1  1  +1  or  -1  -1  +1  faces  are  permissible, 

e.g., 

-2.  -1  +  2.  -1  +  0.  +1  *  0. 

However,  with  -1  +1  +1 

-2.  -1  +  2.1  +  0.  +1  =  4 

the  vectors  are  not  orthogonal  and  so  are  not  allowed. 

As  an  example,  the  following  cards: 

FIL111 

CORNERLINE  14-6  17-3 

FACE  GOLD  -1  1  -1 

ENDOBJ 

defines  a  FIL 111  covered  with  gold  smoothing  a  step  with  a  corner  line 
running  from  1  4  -6  in  the  YZ  plane,  between  the  positive  Y  and  Z 

axis  to  1  7  -3.  The  face  of  the  FILlll  points  in  the  negative  X  and 

Z  directions  and  positive  Y  direction.  (See  Figure  6/11.) 


Figure  6/11.  FILlll. 
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6.10.23  PLATE 


Notes: 

1.  PLATE:  is  the  building  block  keyword. 

2.  CORNER  x  y  z:  defines  the  vertex  of  the  thin  plate  with  the 
lowest  indices  (see  6.10.15,  note  2). 

3.  DELTAS  ax  Ay  az:  defines  the  length  of  the  plate  along  the 
three  axis  directions.  A  PLATE  may  be  thought  of  as  a  cuboid 
(or  RECTAN)  (see  6.10.15)  with  zero  thickness  in  one  direction. 
Hence  one  of  ax,  Ay  and  az  must  be  zero.  For  example,  if  Ay  is 
chosen  to  be  zero  the  PLATE  will  lie  in  the  xz  plane. 

4.  /X  V 

TOP  +  I  Y  )  ALUMIN : 

assigns  the  material  ALUMIN  to  the  TOP  surface  of  the  plate. 

The  "TOP"  surface  may  be  either  in  a  +  or  -  axis  direction. 

This  choice  is  arbitrary  unless  a  "double  point"  conflict  is 
possible.  Double  point  conflicts  are  explained  in  Section 
6.11.11. 

BOTTOM  Y  )  KAPTON: 

assigns  the  material  KAPTON  to  the  other  side  of  the  plate.  If 
"top"  were  chosen  as  +X  then  bottom  must  be  -X,  and  so  on.  Note 
that  the  choice  of  x,  y  or  z  must  coincide  with  the  ax.  Ay  or  az 
chosen  to  be  zero. 


6.10.24  SLANT 


The  SLANT  object  should  be  thought  of  as  a  WEDGE  with  the 
100-type  surfaces  left  undefined.  The  FACE  card  is  transformed  to  a 
TOP  card,  and  a  BOTTOM  card  is  added.  The  CORNER  is  remote  from  the 
slanted  plate,  and  is  where  the  CORNER  of  a  WEDGE  would  be  if  we  were 
defining  the  FACE  of  a  WEDGE.  Similarly,  the  LENGTH  card  corresponds 
to  that  of  a  WEDGE.  The  syntax  is 


SLANT 

CORNER 

ix  jy 

kz 

TOP 

matl  nx 

BOTTOM 

matl 

LENGTH 

lx  ly 

lz 

ENDOBJ 

6.10.25  MORE  OBJECT  DEFINITION  KEYWORDS 


In  addition  to  the  building  block  keywords  and  the  parameter 
cards  that  follow  VEHICL  also  recognizes  a  few  other  keywords.  With 
these  and  the  building  blocks  a  complete  object  definition  f i le  can 
finally  be  constructed.  Let  us  examine  the  remaining  keywords  and 
their  effect  one  by  one. 

ENDSAT 


Just  as  ENDOBJ  terminates  a  set  of  building  block  parameter 
cards,  so  the  keyword  'ENDSAT'  terminates  the  whole  object  definition 
file.  After  reading  an  'ENDSAT'  card  VEHICL  stops  trying  to  read  any 
more  keywords  from  the  object  definition  file  and  begins  to  process 
the  information  it  has.  Note  that  ALL.  object  definition  files  must 
end  with  an  ' ENC SAT '  card. 


COMMENT 


"V.V.V.'.  V.V.'O , 
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VEHICL  ignores  anything  written  on  the  same  80  character  line 
(or  card)  that  begins  with  the  keyword  'COMMENT'.  This  allows  the 
user  to  include  notes  or  reminders  in  long  and  complicated  object 
definition  files,  e.g.. 


COMMENT  DEFINE  OCTAGONAL  BODY 
OCTAGON 

AXIS  -6  0  2  -8  0  2 


OFFSET 

The  card 

OFFSET  x  y  z 

relabels  the  grid  center  to  be  (NX+l)/2-X,  (NY+l)/2-Y,  (NZ+l)/2-2, 

S-x,  9-y,  17-z  for  a  17  x  17  x  35  inner  grid.  The  so-called 
’’absolute"  POLAR  coordinate  system  labels  the  axes  from  1  to  17  in  the 
X  and  Y  direction  and  1  to  33  in  the  Z  direction.  In  this  "absolute 
system"  the  center  of  the  grid,  which  we  had  previously  labeled 
(0,  0,  0,)  becomes  (9,  9,  17).  So  we  may  move  from  the  more  intuitive 
(0,  0,  0)  centered  system  to  the  "absolute"  system  with  the  command 
OFFSET  000 

To  illustrate  the  difference  the  following  two  sets  of  cards  define  a 
sphere  centered  at  the  center  of  the  grid. 
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Default  i 

coordinate  system 

Absolute 

QSPHERE 

OFFSET 

CENTER  0 

0  0 

QSPHERE 

DIAMETER 

7 

CENTER  9 

SIDE  3 

DIAMETER 

MATERIAL 

KAPTON 

SIDE  3 

ENDOBJ 

MATERIAL 

ENDOBJ 

coordinate  system 

0  0  0 

9  17 
7 

KAPTON 
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The  coordinate  system  may  be  adjusted  with  the  OFFSET  command  anytime 
at  any  point  between  building  blocks.  The  active  system  is  always  the 
default  or  the  coordinate  system  defined  by  the  most  recent  OFFSET. 


CONDUCTOR 


•  POLAR  allows  for  both  insulating  and  conducting  materials 

i 

ji  (Chapter  6. T2).  It  assumes  that  all  surface  materials  cover  an 

underlying  conductor.  Up  to  15  separate  conductors  are  allowed.  Each 
building  block  is  associated  with  a  particular  conductor.  This 
;  association  is  made  by  preceding  all  building  block  definitions 

|  associated  with  the  first  conductor  with  the  card: 

CONDUCTOR  1 

Similarly,  blocks  associated  with  a  second  conductor  are  preceded  by 
;  the  card 

:  CONDUCTOR  2 

i 

,  and  so  on.  If  no  CONDUCTOR  card  is  included  in  the  object  definition 

file  all  building  blocks  will  be  associated  with  CONDUCTOR  1.  In  the 

I 

i  same  way  any  building  blocks  defined  before  VEHICL  encounters  a  card 

CONDUCTOR  n  (n  >  1) 

;  will  be  associated  with  conductor  1.  All  subsequent  blocks  will  be 

!  associated  with  conductor  n,  until  another  conductor  card  is 

encountered . 

I 

\ 

|  It  is  conventional  to  choose  conductor  1  as  the  satellite  ground 

1  conductor.  Skipping  conductor  numbers  is  not  recommended. 


DELETE 


DELETE  allows  the  user  to  modify  building  blocks  already  defined 
by  selectively  "deleting"  filled  or  partially  filled  cells  (i.e., 
"deleting"  them  by  making  them  empty). 

DELETE  x  y  z 

empties  the  filled  cell  with  the  indices  of  its  lowest  index  vertex 
given  by  x  y  z.  (The  lowest  index  vertex  is  the  one  with  the  sum  of 
its  X,  Y  and  Z  coordinates  equal  to  the  least  positive  number.)  The 
coordinates  x,  y,  z  refer  to  the  coordinate  system  presently  active 
(i.e.,  the  default  system  or  that  associated  with  the  most  recent 
OFFSET  command).  The  DELETE  command  requires  great  care  in  its  use. 

It  does  not  assign  materials  to  surfaces  that  are  newly  exposed  by  the 
removal  of  a  filled  element.  The  user  must  do  this  by  defining  a  new 
object  or  objects  with  surfaces  that  coincide  with  those  newly 
exposed.  This  is  most  easily  done  by  overlaying  objects  (6.14). 

COMPRESS 

Since  there  is  a  limit  of  1250  to  the  number  of  surfaces  on  an 
object  (the  rectangle  defined  in  Figure  6/5  has  62  surfaces),  large 
complex  objects  sometimes  contain  interior  surfaces  which  need  to  be 
removed.  Normally  these  surfaces  are  removed  when  the  satellite 
definition  is  complete  or  when  the  number  of  surfaces  exceeds  the 
surface  limit  between  building  blocks,  COMPRESS  forces  the  existing 
interior  surfaces  to  be  removed  immediately.  An  example  of  the  syntax 
is 


ENDOBJ 

COMPRESS 

RECTAN 
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MiARKTB 


Sometimes  when  defining  odd  objects  with  unusual  geometries, 
undefined  double  points  will  be  found.  One  way  to  patch  the  object  is 
to  use  the  MARKTB  command  to  define  an  element  and  its  associated 
surfaces  to  be  TOPS  or  BOTTOMS. 

KARKTB  1  2  2  TOP 

KARKTB  1  2  1  BOTTOM 

The  first  KARKTB  comm, and  forces  the  cell  with  lowest  index 
vertices  of  (1,2,2)  to  be  marked  as  a  TOP  element.  The  second  line 
marks  the  element  below  the  first  in  the  Z-direction  as  a  BOTTOM 
cell.  It  should  be  noted  that  these  index  vertices  will  be  affected 
by  previous  OFFSET  commands.  (See  Section  6.11.11  for  more  hints  for 
dealing  with  double  points.) 

OTHER  WORDS 

Any  other  words  that  VEHICL  reads  in  the  object  definition  file 
are  assumed  to  be  the  names  of  new  materials  and  VEHICL  then  expects 
three  more  cards  defining  the  material  properties  (6.12)  to  follow 
immediately. 

6.11  DEFINING  AN  OBJECT:  AN  EXAMPLE 

The  input  file  of  Figure  6/13  defines  an  object  consisting  of  an 
ALUMINUM  slab,  trimmea  with  four  KAPTCN  wedges  ana  four  TEFLON 
tetrahedra,  and  topped  with  a  GOLD  sphere.  Three  views  of  the 
resulting  object  are  shown  in  Figure  6/14. 


CC*WENT  ALUPI&CP  SLAB 
"  £  C  T  A  N 

COYNES  -2  -4  -1 
DELTAS  6  6  1 
SURFACE  *Z  ALLi“rvuM 
SURFACE  -2  A  L  U  M I N  U  “ 

ENCO°. 

CC.**MENT  FOUR  KAPTCN  WEDGES 
■  EDGE 

CORNER  -2  -*»  -1 
FACE  kapton  -1  C  1 
LENGTH  1  8  1 

SURFACE  -2  KAPTCN 
ENDOB J 
HEDGE 

CORNER  -2  -4  -1 
FACE  KAPTCN  P  -1  1 
LENGTH  6  1  1 

SURFACE  -2  KAPTCN 
ENDOe J 
HEDGE 

CORNER  3  -4  -1 
FACE  KAPTCN  1  3  1 
LENGTH  1  8  1 
SURFACE  -2  KAPTCN 
END09  u 
HEDGE 

CORNER  -I  <•  -1 
face  kaptqn  n  i  i 

LENGTH  6  1  1 

SURFACE  -2  KAPTCN 
E N DOS  j 

CCHENT  FOUR  TCFLCN  TET»AHEDRA 

tetrahecocn 

CORNER  -!  -4  -1 
PACE  TEFLCN  -1  -1  1 
LENGTH  1 
SURFACE  -2  TEFLCN 
ENOOBJ 
tetrahedron 

CORNER  2  -4  -1 
FACE  TEFLCN  1  -1  1 
LENGTH  1 
SURFACE  -2  TEFLCN 
ENOCH J 
TETRAHEDRON 

CORNER  J  4  -I 
FACE  TEFLCN  1  1  1 
LENGTH  1 
SURFACE  -2  TEFLCN 
ENOOe J 
TETRAHEDRON 

CORNER  -2  4  -1 
FACE  teflon  -1  i  1 

LENGTH  1 
SURFACE  -2  TEFLCN 
ENG09 J 

COMMENT  ALL  TOPPED  BY  A  GOLD  SPHERE 
CSPHERC 

CENTER  Z  Z  Z 
flAHETER  4 
SICE  2 

MATERIAL  GOLD 
ENC03U 
ENO  SA  T 


CUBOID 


FOUR  WEDGES 


FOUR 

TETRAHEDRA 


SPHERE 


Figure  6/13.  Object  definition  example. 


6.11.10  LIMITATIONS  IN  OBJECT  DEFINITION 


It  is  probably  fair  to  say  that  you  can  link  building  blocks 
together  and  nine  times  out  of  ten  there  will  not  be  a  problem.  This 
section  deals  with  the  other  one  time  out  of  ten,  when  what  appears  to 
be  a  perfectly  reasonable  combination  of  building  blocks  is  rejected 
by  VEHICL.  We  itemize  here  a  rather  formidable  list  of  object 
definition  "dcn'ts".  However,  you  should  remember  that  it  takes  hard 
work  to  break  more  than  one  or  two  of  these  rules  defining  any  one 
object  if  you  use  a  little  common  sense. 

1.  All  exposed  surfaces  must  be  assigned  materials. 

2.  The  parameter  cards  for  each  building  block,  discussed  in 
Section  6.10.14,  must  appear  in  the  order  shown,  ana  no  other. 

3.  The  object  must  not  touch  the  object  grid  boundary  planes  at  any 
point. 

4.  Thin  plates  sharing  the  same  volume  element  can  do  so  only  if 
the  TOP  face  of  one  shares  volume  with  the  TOP  of  the  other,  or 
the  BOTTOM  face  of  one  shares  volume  with  the  BOTTOM  face  of  the 
other.  TOP  faces  may  not  share  volume  elements  with  BOTTOM, 
faces. 

5.  Thin  plates  may  only  intersect  each  other  at  the  edges  or 
corners. 

6.  Double  points  must  be  assigned  TOP  and  BOTTOM  sets  (see  Section 

6.11.11). 

(Rules  4  through  6  are  all  manifestations  of  conflicts  involving 
double  and  triple  points.) 

6.11.11  DOUBLE  POINTS 

Thin  plates  may  have  different  potentials  on  their  two  surfaces, 
yet  they  occupy  only  one  plane  of  grid  points.  These  grid  points  must 
therefore  be  associated  with  two  distinct  sets  of  potentials.  For 
this  reason  they  are  called  double  points.  The  two  sets  of  potentials 
associated  with  each  half  of  the  double  points  are  distinguished  by 
calling  one  set  'TOP'  and  one  set  ' BOTTOF1.  Recall  (6. 1C. 23)  that  the 
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surfaces  of  a  thin  plate  may  be  defined  as  'TOP'  or  ' BOTTOM ' 
regardless  of  whether  their  surface  normal  points  along  a  positive  or 
negative  axis  direction:  The  TOP  and  BOTTOM  definition  refers  to  the 
(arbitrary)  choice  of  which  set  of  potentials  (TOP  or  BOTTOM)  to 
associate  with  each  surface.  When  double  points  share  a  volume 
element  they  must  all  be  of  the  same  type;  i.e.,  all  TOP  or  all 
BOTTOM.  This  is  the  basis  for  rule  4  in  Section  6.11.10. 

Double  points  also  occur  when  other  building  blocks  touch  in 
such  a  way  that  their  single  points  come  together  to  form  a  common 
vertex  of  two  "disjoint"  volume  elements.  By  "disjoint"  volume 
elements  we  mean  elements  physically  separated  from  each  other  by 
solid  surfaces.  This  is  shown  for  two  cuboids  touching  along  one  edge 
only  in  Figure  6/15.  The  row  of  points  along  the  touching  eages  are 
double  points  and  one  set  must  be  defined  as  BOTTOM.  This  may  be  done 
by  defining  a  thin  plate  touching  the  common  edge.  If  the  exterior 
surface  of  the  plate  pointing  into  one  of  the  disjoint  volumes  is 
'BOTTOM'  then  the  half  of  the  double  point  associated  with  the  other 
disjoint  volume  becomes  'TOP'. 


X 


Figure  6/15.  Profile  of  two  cuboids  sharing  a  common  edge  and 

resultant  double  points.  Heavy  lines  show  possible 
orientations  for  the  definition  of  a  thin  plate  to  re¬ 
solve  the  conflict. 


Because  of  the  way  surface  cell  potentials  are  assigned  to  grid 
points,  the  edges  of  thin  plates  are  only  single  points.  However,  a 
thin  plate  touching  another  building  block  with  its  edge  creates  a  row 
of  double  points  similar  to  that  caused  by  two  cuboids  touching  at  an 
edge  (Figure  6/16).  These  double  points  are  automatical ly  assigned 
TOP  and  BOTTOM  sets. 

Double  point  ambiguities  can  also  be  resolved  on  an  element  by 
element  basis  using  the  MARKTB  command  discussed  in  Section  6.10.25. 

6.11.12  TRIPLE  POINTS 

A  triple  point  is  said  to  occur  when  a  vertex  is  common  to  three 
or  more  disjoint  volume  elements.  Triple  points  are  illegal  I  The 
easiest  way  to  get  a  triple  point  is  to  define  one  thin  plate  passing 
through  another.  This  is  not  allowed  (rule  5,  Section  6.11.10). 
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6.12.10  MATERIAL  PROPERTIES 


Each  material  name  (e.g.,  KAPTON,  GOLD,  FRED  (the  name  is 
arbitrary))  has  associated  with  it  a  list  of  material  properties.  The 
name  of  each  material  and  the  values  for  each  material  property  are 
supplied  by  the  user  in  the  object  definition  file.  (This  is 
explained  in  Section  6.12.11.)  The  nineteen  material  properties  are 
summarized  in  Table  6/5.  Here  we  examine  each  one  in  more  detail. 

DIELECTRIC  CONSTANT  (PROPERTY  1) 

Property  1  contains  the  relative  dielectric  constant  for  an 
insulating  material  er 


where  e  is  the  absolute  dielectric  constant  and  eQ  is  the  dielectric 
constant  of  free  space.  er  is  dimensionless. 

THICKNESS  (PROPERTY  2) 

Property  2  gives  the  thickness  d  of  a  dielectric  film  covering 
an  underlying  conductor  in  meters,  d  is  arbitrary  and  may  be  chosen 
to  be  more  or  less  than  a  mesh  unit.  However,  note  that  POLAR  uses 
thin-film  approximations  in  many  of  its  calculations  involving 
surfaces  (Section  4.52). 

BULK  CONDUCTIVITY  (PROPERTY  3) 

Property  3  gives  the  bulk  conductivity  oQ  of  the  surface 
material  in  ohrns-^  m-^.  o0  is  assumed  to  be  the  value  appropri¬ 
ate  for  a  sample  not  exposed  to  any  radiation  and  not  subject  to  any 
internal  electric  fields.  Field  enhancement  and  radiation  enhancement 
of  o0  are  not  currently  modeled  by  POLAR.  A  value  of  -1  indicates 
that  the  material  is  a  metallic  conductor. 


TABLE  6/5.  MATERIAL  PROPERTIES 
(see  Section  6.12.10  for  notes) 


Property  No.  User  Input  Units 


Desci 


ohms- ^  m  ^ 


angstroms 

None 

angstroms 

None 


Relative  dielectric  constant 

Dielectric  material  thickness 

Bulk  conductivity  (=  -1  for  a 
metallic  conductor) 

Atomic  number 

Maximum  secondary  electron  yield 
for  electron  impact 

Primary  electron  energy  that 
produces  maximum  secondary  yield 

Range  parameters  (4.3) 

R  =  P7EP8  +  pgEP10 


ohms  square" 


Volts 


Secondary  electron  yield  due  to 
impact  of  1  keV  protons 

Incident  proton  energy  that 
produces  maximum  secondary  electron 
yield 

Photoelectron  yield  for  normally 
incident  sunlight 

Surface  resistivity  (=  -1  for 
non-conducting  surface) 

Naximum  (absolute)  potential 
attainable  before  a  discharge  must 
occur 


Volts 


ohms-l  m-^ 
(m3  s-3)-1 


Maximum  potential  difference 
between  surface  and  underlying 
conductor  before  a  discharge  must 
occur 

Radiation-induced  conductivity 
coefficient  (k) 

Radiation-induced  conductivity 
power  (a) 


Naterial  density 


ATOMIC  NUMBER  (PROPERTY  4} 
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Property  4  is  the  atomic  number  for  pure  elements  or  the  mean 
atomic  number  for  chemical  compounds;  e.g.,  polyethylene  (CHg) 
has  a  mean  atomic  number  of  (6  +  1  +  l)/3  =  2.7. 

SECONDARY  YIELD  (PROPERTIES  5  AND  6) 

Properties  5  and  6  are  the  coordinates  of  the  maximum  in  the 
secondary  electron  yield  curve  of  the  material.  The  secondary  yield 
curve  is  a  plot  of  secondary  yield  6 

current  of  secondary  electrons  emitted 
6  *  incident  primary  electron  current 

for  normally  incident  electrons,  against  the  incident  energy  of  the 
primary  electron  E.  This  is  further  discussed  and  illustrated  in 
Section  4.52.  Property  5  contains  and  property  6  contains 

iTlaX 

E  in  keV. 
max 

ELECTRON  RANGE  (PROPERTIES  7,  8,  9  AND  10) 

Part  of  the  secondary  electron  emission  formulation  requires  an 
analytical  form  for  the  "range"  of  electrons  in  the  material.  The 
range  is  the  depth  to  which  the  electrons  can  penetrate  the  material 
as  they  are  continuously  slowed  down  by  losing  energy  to  the  material 
lattice.  POLAR  uses  a  biexponential  form.  If  Py,  Pg,  Pa,  and 
P^  are  properties  7-10  respectively,  the  range  R  is  given  by 

R  =  P7  ES  +  P9  EPl° 


The  four  parameters  are  obtained  from  fits  to  stopping  power  data 

0  -10 

(Section  4.52).  The  range  is  determined  in  A  (10  m).  If  no 


<-.v  /  0 


v,>  ^  v  .•  v  -■  -  v  v 


reliable  stopping  power  data  or  four  parameter  fits  are  available,  the 
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range  may  be  estimated  from  Feldman's  formula  J  automatically  by 
assigning  -1  to  property  7.  In  this  mode  properties  7-10  are  assigned 
as  follows: 

P7  --1 
PQ  =  null 

o  3 

Pg  =  material  density  (g  cm"  ) 

P^q  =  mean  atomic  weight  (AMU) 

The  mean  atomic  weight  is  calculated  in  the  same  way  as  the  mean 
atomic  number  (property  4)  using  atomic  masses  rather  than  numbers. 

ION  INDUCED  SECONDARY  EMISSION  (PROPERTIES  11  AND  12) 

Secondary  emission  of  electrons  due  to  ion  impact  is  also 
treated  using  a  two  parameter  theory  (4.52).  Parameter  11  contains 
the  yield  for  1  keV  normally  incident  protons  and  parameter  12  the 
proton  energy  that  produces  the  maximum  electron  yield.  The  secondary 
emission  properties  due  to  impact  of  ions  other  than  protons  are 
assumed  to  be  identical  to  the  proton  values. 

PHOTOEMISSION  (PROPERTY  13) 

Property  13  contains  the  yield  of  photoelectrons  from  the 
surface  material  exposed  to  the  solar  spectrum.  The  intensity  is  that 
measured  on  earth  93,000,000  miles  from  the  sun.  (Earth  orbit 
altitudes  are  negligible  by  comparison  and  the  intensity  of  the  sun 
close  to  earth  may  be  considered  constant.) 


SURFACE  RESISTIVITY  (PROPERTY  14) 


Property  14  gives  the  intrinsic  surface  resistivity  in  the  "ohms 
per  square".  This  rather  odd  unit  is  used  to  distinguish  the 
resistivity  coefficient  (property  14)  from  the  actual  surface 
resistance  (in  ohms)  calculated  by  POLAR.  Consider  two  points  in  a 
plane  A  and  B,  a  distance  apart.  If  is  the  "width"  of  the 
plane 

surface  resistance 

i.e.  ohms 


L2 

4 

A 

B 

=  surface  resistivity  x  t— 

l2 

dimensionless 

«  (ohms  per  square)  x  geometrical 

factor 


POLAR  uses  the  surface  resistivity  per  square,  times  a  geometrical 
factor  it  calculates  to  determine  the  surface  resistance  between  two 
adjacent  materials. 

The  intrinsic  surface  conductivity  is  due  to  the  migration  of 
electrons  along  the  surface  layer  aided  by  adsorbed  impurities  and 
defects. 

Surface  conductivity  may  be  omitted  from  the  current 
calculations  completely  by  choosing  property  14  to  be  negative. 

DISCHARGE  ANALYSIS  (PROPERTIES  17,  18,  19,  20) 

Currently  under  development. 

PROPERTIES  17,  18,  IS,  20  (RADIATION  INDUCED  CONDUCTIVITY) 

Currently  under  development. 

6.12.11  DEFINING  MATERIALS 

New  materials  are  defined,  and  their  properties  assigned  inside 
the  object  definition  file  (6.10.11).  The  object  definition  file  is 
read  by  POLAR  module  VEHICL.  VEHICL  interprets  any  word  that  it  does 
not  recognize  as  a  building  block  keyword  (or  their  parameter  cards 
(6.10.25))  as  the  definition  of  a  new  material  name.  New  material 
names  may  not  appear  inside  building  block  definitions  (i.e.,  between 
a  building  block  keyword  and  an  ' ENDOBJ '  statement). 


Following  the  material  name,  VEHICL  expects  to  find  three 
additional  cards  specifying  20  constants  as  the  material  properties  to 
be  associated  with  the  name.  The  20  constants  correspond  to  properties 
1-20  and  are  read  sequentially;  i.e.,  the  first  constant  read  is  inter¬ 
preted  as  property  1,  the  second,  property  2,  and  so  on.  They  are 
arranged  sequentially,  eight  per  card,  so  that  cards  1  and  2  each  have 
eight  numbers  and  card  3,  four  numbers.  Formally  each  number  is 
written  in  a  field  of  up  to  ten  characters,  but  POLAR  will  read  the 
cards  in  free  format.  No  units  need  be  specified.  POLAR  will  assume 
the  units  given  in  Table  6/5  and  no  others.  For  properties  not 
requiring  any  input  such  as  property  20,  or  properties  17-19  for 
conductors,  some  constant  must  be  entered  but  its  value  is  arbitrary. 
(POLAR  will  not  actually  use  the  values  entered  but  expects  to  read 
something. ) 

Once  the  three  material  property  cards  have  been  read  VEHICL  is 
ready  to  accept  any  other  keywords  or  more  material  names.  POLAR  will 
recognize  up  to  fifteen  different  materials. 

Materials  must  be  defined  before  they  are  referred  to  in  an^ 
building  block  definition.  For  example,  if  I  assign  the  surface  of  a 
sphere  to  be  1 FSTUFF '  with  the  card 

MATERIAL  FSTUFF 

if  'FSTUFF'  and  its  material  properties  have  not  been  declared  earlier 
in  the  object  definition  file,  an  error  will  occur  and  execution  will 
stop.  For  this  reason  all  the  materials  to  be  used  are  usual  ly 
declared  at  the  very  beginning  of  the  object  definition  file.  This  is 
shown  in  Figure  6/17. 


6.12.12  DEFAULT  MATERIALS 


There  is  one  case  where  the  user  can  forget  to  define  his  or  her 
rriaterials  and  get  away  with  it.  When  VEHICL  encounters  a  material 
that  hasn't  been  defined  already,  before  an  error  occurs,  it  checks 
the  following  list  of  default  materials: 

ALUM IN 

AQUADG 

CPAINT 

GOLD 

INDOX 

MAGNES 

SCREEN 

KAPTON 

NPAINT 

SI02 

SOLAR 

TEFLON 

SILVER 

If  the  material  is  included  in  this  list,  it  becomes  one  of  tne  up  to 
fifteen  defined  materials  and  its  properties,  stored  internally,  are 
automatically  entered  as  VEHICL  input  by  the  code.  The  properties  of 
these  materials  are  shown  in  Table  6/6.  Any  further  reference  to  the 
material  will  assign  the  same  set  of  properties  to  the  surfaces 
concerned.  If  the  material  is  not  found  in  this  list,  an  error  will 
occur.  These  material  properties  are  currently  a  carryover  from 
NASCAP.  New  default  materials  will  be  included  in  future  revisions. 

If  two  sets  of  material  properties  are  defined  with  the  sane 
name,  or  names  with  the  same  first  four  letters,  two  of  the  fifteen 
possible  materials  are  used  up  but  only  the  first  set  of  material 
properties  are  used.  For  example,  if  GOLD  is  referenced  before  it  is 
defined  in  the  runstream,  the  default  material  properties  of  gold  will 
be  associated  with  a  1 1  gold  surfaces  in  the  object  definition  file. 


-L‘ 


«»  « 


6.1-50 


TABLE  6/6 

MATERIAL  PROPERTIES 


MATERIAL  i:  ALU* 


PROPERTY 

Input  value 

;Coe  val-e 

1 

dielectric  constant 

i.:o*csc 

(NONE ) 

1.-3*000 

(NONE  > 

2 

thickness 

1.30-30! 

“ETEOS 

1.-2-002 

-ESH 

J 

CONCUCTtvrTY 

-i.cr.coc 

MHC/M 

*i .or  *oo c 

YHO/H 

« 

ATOMIC  NUMBER 

1. JC*CC1 

(NONE) 

1.30*001 

(NONE) 

5 

OELTA  MAX  >C0£FF 

9.70-0-1 

(NONE  ) 

5.18*000 

INONE) 

6 

E-max  >0EPTh»*-1 

3  » 00-00 1 

KEV 

3  .  —  0  —0  0  2 

ANG— Cl 

T 

RANGE 

1 •59*002 

ANG. 

1.23*002 

ANG. 

a 

EXPONENT  >  RANGE 

8 .90*001 

(NONE) 

3.87*002 

ANG. 

9 

RANGE  >  EXPONENT 

2.20*032 

ANG  • 

e. 03-001 

( NONE ) 

10 

EXPONENT 

l.T6*C00 

INONE ) 

1.76*900 

( NONE  1 

11 

TIElO  pop  1h£V  ppotqns 

2.““- 321 

(NONE ) 

2.““-C01 

(NONE  I 

12 

MAX  OS/OX  FOP  PPOTONS 

2.3~*2G2 

«£v 

2.30*032 

»£v 

1  J 

PHCTOCU«°ENT 

“.32-205 

A/K«»2 

v  .0.0-C05 

a  / 

1“ 

SuPFACE  SESISTIvITY 

— 1.00*0 —C 

OH«S 

-8.d5-31» 

V-S/C 

15 

SPACE  91  SC  HA  POE  =>0T«L 

..-c*oo“ 

VOLTS 

..——*—  On 

VCLTS 

16 

INTEPNAL  OISCHA-GEPOT’L 

2. ;c-coi 

VOLTS 

2.00*003 

VOLTS 

IT 

PAON  INOUCEOCONO'YCOEFFT 

09-013 

mmCmSO 

1.03-313 

“hOMSi 

Id 

PAOn  INOUCEOCONCYPOkEP 

03*032 

(NONE) 

1. 00-300 

1  NONE ) 

19 

CENSITY 

1.00*001 

KG/N»i 

1.30*003 

*G/m»3 

20 

2.0P*C01 

-1 .00*300 

-ATERIAL  2:  A  CU  A 


PPQ  PE  P  T  Y  INPUT  VALUE  CODE  VALUE 


1 

OIELECTPIC  CONSTANT 

1.30*002 

(NONE ) 

1.39*202 

(NONE  I 

A. 

Thickness 

1 • 2C-003 

-ETEPS 

..3C-322 

-ESn 

T 

concuct: vi ty 

-1.30*320 

“mc/“ 

L  ♦  »  Z  Z  Z 

-hc/» 

4 

ATOMIC  N U“6E  P 

o .02 *330 

incmEi  : 

>.zz*ccr 

INONE) 

5 

OELTA  «AX  >COEFF 

1 .-0*000 

(NONE) 

7  •  «,6  ♦CuC 

1  NONE ) 

6 

E--AX  )OEPTh«»-i 

5.33-3-1 

K  E  V 

ANG-r. 

7 

pangE 

-1.30*030 

ANG.  5  •  o  2  *C C 2 

*N  G  . 

a 

Exponent  >  Range 

.30 

INCNE 1 

- 

•  Wb 

A  NG  . 

9 

range  >  exponent 

—  .02—-  —  C 

ANG. 

1.55*232 

1  NONE ) 

10 

Exponent 

1.23*00 1 

(NONE )  1.22*332 

INO.NF) 

n 

yield  Fop  IkEV  ppotqns 

■*.5  5-201 

INCNt)  •*. 55-2-1 

(NONE) 

12 

“AX  DE/OX  FOP  PROTONS 

1 .  »c*('02 

«E  v 

a  •  •*  2 #  c  c  r 

«  E  V 

13 

PmOTCCU9°ENT 

0.13-305 

‘/“••c  2 • 1C  *905 

A  /  *  *  *  2 

1  “ 

surface  resistivity 

-  1 • -2*r3" 

OHKS 

».oS-Cl 

(•5/1 

15 

SPACE  DISCHARGE  p0  T  *L 

1.  50  *3  J<* 

volts 

.3(2*23“ 

VCLTS 

lb 

INTERNAL  2  ISChABGEoqT *L 

2. 32*201 

VCLTS 

.  2  •  3  2  T 

VCLTS 

,  T 

r a o n  :ncuceccono*ycoefft 

.  .  j  2  —  2 1  - 

“hC^S J 

•  -2 -2 1  I 

“HC*  S  5 

la 

pa C N  INJLCE3CCNG  'YpO.£P 

i.30-000 

(NCNC  t 

• -3*333 

(NONE) 

19 

DENSITY 

1 .30-32  3 

KG/M*’ 

.;2»9s: 

•>  3  /  “  •  I 

20 

2*02  *C— 1 

- 

.-0  *C-3 

.'A'VA'%  .v.'<  J-.j,'  -  .  -  .  -  .  V  .  ■  .  ■  V  •  •  .  *  >  *  ■  • 
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TABLE  6/6 

MATERIAL  PROPERTIES  (Continued) 


“ATERlAL  Jj  CP*I 


1 

DIELECTRIC  CONSTANT 

Tu  T  C  M  <u  C  c  c 

j .50*03" 

t - “C-H- T 

(NONE  I 
METERS 

3. S3 ♦ICC 

(NONE  ) 
ME  Sm 

CONDUCTIVITY 

l.MU  .4. 

-1.33*033 

MHO/“ 

•  »W  '  "  «  y  4 

”1 »wu +?  ZC 

mho/m 

« 

ATOMIC  NUM8ER 

s.ao*<?3Q 

(NCNE) 

a. 00*030 

(NCNE) 

5 

DELTA  *AX  >co eff 

2 • IC *C—3 

INCNE) 

A.wS *0u 1 

INCNE) 

6 

E-“4X  >0EPThmm-1 

1.SC-C31 

KEV 

».74  —034 

ANG-C1 

7 

Range 

T  •  1 5  •  DC  I 

ANG. 

4.29-OCI 

ANG  . 

a 

EXPONENT  >  P*NSE 

o.CC-CSl 

(NONE) 

S. 32*002 

ANG. 

9 

RANGE  >  EXPONENT 

3.12*102 

ANG  . 

6.30-33 1 

(NONE) 

10 

Exponent 

1.77*500 

(NCNE 1 

1 »  7T  *000 

(NONE) 

11 

VIElO  PoR  IkEV  protons 

4.S5-CQI 

(NONE ) 

4.SS-C31 

(NONE ) 

12 

MAX  OE/OX  FOR  PROTONS 

1.<*G*C32 

KEv 

l.O»0C2 

KEV 

13 

PHOTOCURRENT 

2.3G-C35 

A/M»*2 

2.QQ-D0S 

A/»M*2 

1* 

SURFACE  resistivity 

-i.oo*ao/? 

OHMS 

-a.as-aiJ 

v-S/O 

IS 

SPACE  01 SCHAPGE  POT'L 

I « jO *C3“ 

VOLTS 

:.30*0C4 

VOLTS 

16 

INTERNAL  0  ISCHARGEPOT'L 

E.GO.CGI 

VOLTS 

2.33*30 1 

VOLTS 

IT 

°ACN  INOUCEOCONO’YCOEFFT 

1.0C-01? 

"HCMSS 

1.23 -C *  3 

mmoms: 

19 

RAON  INOUCEDCONO^YPO.ER 

1.00*033 

(NCNE ) 

l.oooo'o 

1  NONE) 

19 

CENSITV 

1 • 3C  *003 

»&/»•! 

1.32*33? 

XG/m»3 

20 

-aTEOIal  4  :  GCl 0 

-1.20*330 

PROPERTY 

Input  value 

CODE  value 

1 

OIELECTRIC  CONSTANT 

i.c3*esc 

INCNE  t 

1 .23*003 

(NONE ) 

2 

THICKNESS 

1.Q0-G03 

meters 

1.30-032 

«ESh 

3 

CONDUCTIVITY 

-i.cc*coa 

nhO/m 

-1.33*030 

MMC/M 

4 

atomic  number 

7.9C*C31 

(NCNE) 

7 . 9D*r*01 

(NONE) 

5 

OELTA  max  >COEFF 

a . o  0-  -»0 1 

(NONE ) 

2. V 3 *330 

(NONE) 

6 

E-MAX  )0EPTh*m-1 

i.CG-COl 

*E  V 

2.-2-030 

ANG-Cl 

7 

°a\gE 

o.a»*roi 

ANG. 

6.17  *CQ 1 

anS. 

9 

EXPONENT  )  Range 

9.2C-CGI 

INCNE) 

9.25*001 

•  NG. 

9 

range  >  Exponent 

S.35*r.,l 

ANG  . 

4.22-001 

(  .CNt ) 

1C 

Exponent 

1.71*030 

INONE ) 

1.7T*C3C 

(NONE) 

11 

YIELD  fqo  IkEv  PROTONS 

4.13-03! 

(NONE ) 

4. 13-001 

INCNE ) 

12 

MAX  OE/OX  FOR  PROTONS 

1.35*032 

<E  v 

1. J5-C32 

“tv 

11 

PMOTCCUPPENT 

2.9C— 035 

4/ 

2 . 9  0”D2S 

4 / *••0 

14 

surface  resistivity 

-i.oc*o:c 

3H»S 

-6»a5-Ci? 

v-s  / : 

IS 

space  discharge  ®ot*l 

1 «  — 2 *"3“ 

VOLTS 

1.00*03“ 

VOLTS 

16 

internal  0  ISCHARGEPOT’L 

:.Gr*033 

VOLTS 

2.00  *02  3 

VOLTS 

IT 

PACN  INOLCEDCONC’YCOEFFT 

..00-C13 

“"CMS  3 

1. 20-01? 

“hO-SI 

ia 

=  ACN  IN0UCC3C0N0  •YPO.£P 

1 .00* DuC 

(NCNE ) 

1 .  -  0  *  0  u  c 

( NONE ) 

19 

density 

i.uooo: 

1 .OC  *0  0  3 

n  r,  /  -  •  3 

20 

o.30*rii 

-1.-0-C03 

m: 

» -  w 


/.  .*  . 
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TABLE  6/6 

MATERIAL  PROPERTIES  (Continued) 


MATERIAL  5:  INOO 
PROPERTY 

1  cielECtric  constant 

2  thickness 

J  CONDUCTIVITY 

4  ATOMIC  NUMBER 

s  neLT*  -ax  >coeff 

b  e-«ax  >oepth«*-i 

T  RANGE 

a  exponent  >  range 

9  range  >  Exponent 

13  EXPONENT 

U  Y*£LO  FOR  U£v  P90TONS 

12  “AX  OE/OX  POP  PROTONS 

1J  PHOTOCUPPEM 

l*  SURFACE  RESISTIVITY 

is  SPACE  DISCHARGE  POT*L 

16  INTERNAL  OISCMARGEPOVL 

XT  R AON  INOUCEOCONO’TCOEFPT 

la  RAON  IN3UCE0CQN0*»P0uER 

19  DENSITY 

20 


-aTEPIal  9 :  “*GN 

PROPERTY 

t  dielectric  CONSTANT 

2  Thickness 

J  CONDUCTIVITY 

4  ATOMIC  NUH3tR 

5  OEUTA  hax  >CO£PF 

b  e-max  )OEpth»»-: 

7  RANGE 

8  EXPONENT  >  Range 

9  range  >  exponent 

10  Exponent 

11  yiElO  PQR  IkEV  PROTONS 

12  -ax  OE/OX  FOR  PROTONS 

LJ  PHOTOCURRENT 

14  surface  =esisti.:ty 

15  SPACE  DISCHARGE  POT'L 

lb  INTERNAL  OISCNARGEPOT’L 

17  PA  CN  INDUCEDCONC’YCCEFFT 

is  pa  On  INDLCEOCONO'YROl.iO 

19  DENSITY 

20 


input  value  CODE  value 


1.30*033 

(NCnE  l 

1.3C*CG2 

(NONE ) 

1.30-3C3 

-ETERS 

1.00-302 

-lSh 

-1.00*033 

mmO/m 

-1.33*003 

“MO/- 

2.44*031 

INCnE  t 

2.44.TGJ 

1  NONE  1 

1 .40*030 

incnEi 

i.02*:cc 

INCNEI 

d. 2C-C01 

*E  v 

1.4R-C32 

ANG-C1 

*1 .33*030 

ANG. 

1 . 9  7  *C3  * 

ANG. 

.CD 

INCNE) 

.03 

ANG. 

7.18  *CCC 

ANG. 

2.31*030 

( ncnE i 

5.55*001 

INCNE) 

1.30*000 

INONE ) 

4.92-031 

(NONE) 

4.93-eai 

(NONE  I 

..21*002 

*EV 

1.21*032 

«£  v 

3.20-035 

A/“»*2 

3 .23-205 

A /-••2 

-:.oa*ccc 

OHMS 

-s.dS-'-ir 

v-s/s 

1.00*034 

VOLTS 

1 .30*004 

VOLTS 

2 . JO  *00  3 

VOLTS 

2.00*003 

vclts 

1. 00-011 

MHCMS J 

1.30-013 

MH0MS3 

1.30*000 

I  NONE  > 

1.03*000 

1  none ) 

i.on*ncs 

K6/M*3 

1.30*003 

KG/M-5 

2.20*001 

-l.u3*000 

Input  VALUE 

CODE  VALUE 

1.33*023 

INCNE ) 

1.30*03C 

(NONE) 

l. 33-033 

M1T£®S 

1.33-032 

-ESn 

1 . ..*C30 

“HC/M 

-1.30 *C u . 

•HO/Y 

1. 20*031 

INOnE) 

1.23*221 

I  NONE ) 

R.2C-0J1 

INCNE I 

7.32*233 

(NONE) 

2.52-021 

KEV 

2.7R-032 

ANG-Ol 

•1.30*030 

ANG. 

b.«6*302 

ANG. 

.30 

(NONE) 

.00 

ANG. 

1 . 7“*CCQ 

ANG  . 

1.75*300 

(NONE) 

2.43*231 

INCNE ) 

1.33‘CGC 

I  NON  2 ) 

2 .44-C31 

(NCNE) 

2.44-031 

1  NONE ) 

2.32*032 

KEv 

2.30*022 

K£V 

4.33-035 

*/***»2 

4.30-025 

l/4*»2 

'1 #  ^  ♦  C  C  — 

CM- S 

-8  •  J  ?  -01  ’ 

V-S/C 

1.33*0.4 

VCLTS 

1.22*03* 

VOLTS 

3.30*333 

volts 

2.33*033 

vclts 

1 . 30 “3 1 3 

-HCMS3 

l . 3"  — 3  1 J 

'•HOMS* 

1.3C*C30 

(NONE  1 

1. 20*032 

I  none  I 

1 .32*033 

«G/-“3 

1.33*03! 

2 • 33  *C j 1 

-1.20*230 

.»  A  », 


'o 

*  V. 

W 


» 


#3 


m 


4 


Jl  U.'a* 


a'*.1 


r.  ■  .  v 


r**s 


v>v> 


/V 


^3 


$$ 


>>• 


TABLE  6/6 
MATERIAL  PROPERTIES  (Continued) 


-aTERIal  7:  scre 


PROPERTY 

INPUT  VALJE 

1 

CIElECTUIC  CONSTANT 

1  ...0*230 

(NONE | 

2 

thickness 

1 . 2C-C33 

-ETERS 

I 

CONqUCTIVI  Ty 

-i.;r*pjo 

-HO/- 

* 

*  TOPIC  NUMBER 

1.30*330 

(NCnE) 

5 

OELTA  -A*  >C  OEFF 

.30 

(NONE  ) 

6 

E--AX  >0EPTh««-1 

1.3C.030 

hEv 

7 

range 

1 . G0*CG1 

AN3. 

8 

Exponent  >  range 

I • 53*030 

1 NCNE ) 

9 

RANGE  >  EXPONENT 

•  SC 

ANG. 

IS 

Exponent 

1 .C0*CQ0 

(NONE  ) 

11 

TIElO  POP  Ik EV  PROTONS 

.or 

(NONE) 

12 

“AX  OE/OX  FOR  PROTONS 

*  .*30  *  C  C  3 

KEv 

11 

PhOTOCURRENT 

.33 

A / —4—2 

14 

SURFACE  RESISTIVITY 

-1.30*030 

Ohms 

IS 

SPACE  DISCHARGE  POT'L 

1 . 2C  *034 

VOLTS 

16 

INTERNAL  OISCHARGEPOfL 

2.30*033 

VOLTS 

17 

RACN  INOUCEOCONO ’TCOEFFT 

1.03-C13 

HMCMS3 

16 

RAON  INOUCEOCONO’VPOhER 

1 .3C*C33 

(NONE) 

19 

CENSITV 

1 . 2C*C2  3 

KG/H«3 

20 

2.20*331 

“a  re  rial  a:  kapt 

PROPERTY 

INPUT  VALUE 

1 

dielectric  CONSTANT 

3.5S*CQ0 

(NONE) 

2 

thickness 

1.2  7— C3  4 

-ETERS 

3 

CONDUCTIVITY 

1.&2-C16 

HHO/H 

4 

ATOMIC  number 

5.23*330 

(NCnE) 

s 

OELTA  -AX  >CO£FF 

2.10*330 

(NCNE ) 

6 

E-hax  >OEPTm««-i 

1  •  *  -  — C  w  1 

KEV 

7 

range 

7.15*231 

ANG. 

8 

exponent  >  range 

6.23-331 

incnE) 

9 

range  >  Exponent 

3.12*332 

ANG  . 

10 

exponent 

1.7’*r*32 

(NONE ) 

11 

7IElD  FqR  IkEv  PROTONS 

4.55-301 

(NONE  ) 

12 

-AX  OE/OX  FOR  PROTONS 

1.43*332 

kE  v 

12 

PhOTOCURRENT 

2 .33-23 5 

A/“»*2 

1» 

SoRFACE  RESISTIVITY 

1.30*016 

OM-S 

IS 

SPACE  OISC-ARGE  POT'L 

1  .  . 0  *0 u 4 

VOLTS 

16 

INTERNAL  OISCHARGEPOT'L 

2.23*03 3 

VOLTS 

17 

RAON  INOUCEgCONO’YCOEFFT 

1 .3C—1I 

-HOHSl 

18 

RAON  INUUCEQCONO’YPOaER 

1  .33*323 

(NONE ) 

19 

oensity 

1.30*333 

KG/M*3 

20 

2.30*031 

■v 


-N»  -  ■AlV.'.A,  *-•  -\A.  ■  «-  V  *- 


2C3E  value 


l.-2*C32 

INONE) 

i.l-'-H-j 

“ESn 

•1.33*223 

“hO/- 

1.33*00" 

1  NONE ) 

.33 

INONE) 

1.38-:C1 

A  N  G  —  2  1 

1.53  *0C 1 

ANG. 

o  ^ 

•  kH  — 

ANG. 

1 .  S3  *032 

( NONE ) 

1.00*033 

( NONE ) 

•  Cm 

(NONE) 

i.33*S3C 

K  £  V 

.23 

a/ 

3.85-013 

V-S/O 

1 .20  *3G  4 

VOLTS 

2. 33*203 

VOLTS 

1.23—313 

-H0-S3 

i.3C*03C 

( NONE ) 

1.33*333 

KG/“*I 

l • 30  *C3C 

CODE  VALuE 
3.50*C3C  (NONE) 
1.37-007  i£$h 

1.20-016  “M0/“ 

3. 20*033  (ncnei 
4.36*331  (NONE) 
8.74-332  ang-31 
h.29*C31  ANG. 
S.32**22  «SG. 
b.uC-ICl  (NONE) 
1.77-3CC  (SCNCI 
4.55-301  (NON'’) 
l  •  4  3  ♦  0  li  2  K  £  v 

2 .-^-005  » /“»«2 
8.85*003  V-S/C 
1.03*004  VOLTS 
2.00*027  VOLTS 
1.03-011  -HC-S2 
1.30*0.:  I  NONE ) 
1.00*003  k&/h«: 
1.00-316 


-  *c* 

*4  S  4 


>v 


r. 


.  .  . 

'  V  -  • 
•\--V 
.vO 
»■ *  .  *  . 
■■CvV 

*  » '  »  V 
h-v-v-' 

.\*V* 

trvt' 

>.>V 

y.v.; 


v>: 


■t-'j 


.  ■< 

£\v 

V.v 


Vv 

v  -  • 


v.\': 

.  * .  • , 

w-  -• 


■  ■Ti  -3im  >.<■.  t  'At.  J.  ■ 


■W1 .IBW f U  •-■  ■LH..VJ*'.A11-".1  ■».'  /.  ■*. -PJ ■’.  •». '■■: ■•■ 


"w^  v.v;,’  ?  v v  ->- 

k  v  •  ’ 
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TABLE  6/6 

MATERIAL  PROPERTIES  (Continued) 


* 

6 


taTERIal  9:  npai 


I 


I 


r 

i  * 


PROPERTY 

INPUT  VALUE 

COSE  VALUE 

1 

OIELECTRIC  CONSTANT 

3 . S  C *020 

(NONE ) 

3.5C*C3C 

*  N  C  N  E  > 

2 

thickness 

2.2C-CJ5 

“ETEPS 

5  •  JC+CZ* 

M£S  h 

3 

CONQUC  T I  V I  TV 

5.92-214 

••HO/" 

5  •  *C  i  4 

*hg/ * 

9 

ATOMIC  NUM8E® 

5.33  *C3C 

(NONE) 

s.j'iTca 

(  NONE  1 

5 

CELT*  MAX  >COEFF 

2.12*023 

(NONE) 

3 . 2S  *CC 1 

«  none  i 

6 

E-“A  X  >0£PTh*«-1 

1. 53-031 

9  E  V 

:.4i-«o2 

4NG-C 1 

T 

Range 

-1.JOC3C 

ANG. 

1 .25  *Cu3 

4NC  . 

9 

Exponent  >  range 

(NONE) 

•  20 

4  NS  . 

9 

range  >  exponent 

1 .25*222 

ANG. 

1.51*302 

( NONE ) 

ia 

Exponent 

4 .83*020 

(NONE ) 

1.3 0*032 

f NCNE  > 

n 

yield  fop  Ik£v  protons 

9.ES-C21 

(NONE) 

4*55  -*3  2 1 

INONE 1 

12 

«ax  OE/OX  ®oR  °r0 TONS 

1 .42*002 

KEV 

1. *0*032 

KEV 

13 

OhOTOCuPPENT 

2.30-325 

»/“••; 

2.20-035 

A/"9m2 

19 

surface  resistivity 

1.23*013 

Oh“S 

3  .35 ‘"DC 

v-s/c 

IS 

SPACE  DISCHARGE  POT*L 

1.30*034 

volts 

1 .33 »034 

VOLTS 

16 

Internal  0 ischargepot*l 

2.30*003 

VOLTS 

2.32*023 

VOLTS 

17 

Raon  INOUCEGCONO'YCOEFFT 

1.30-013 

"H0MS3 

1.20-013 

»M0«S3 

18 

RAON  INDUCEDCONG*TPO.£P 

1.30*020 

(NONE) 

1.22*022 

(NONE  ) 

19 

20 

oensity 

1.30*033 

2.2C*QCt 

KG/M*J 

1.22  *03  3 

5 . 9C-0 1  * 

k  G/ * • Z 

"atepial  ia:  sio: 

PROPERTY 

1  3IELECTRIC  CONSTANT 

:  Thickness 

J  conductivity 

<•  atomic  number 

5  0EL1  A  MAX  >COEFF 

6  E--AX  >0EPTm«*-1 

T  RANGE 

a  Exponent  >  range 

9  range  >  Exponent 

10  Exponent 

11  YIELO  fop  IhEv  protons 

12  *AX  CE/OX  FOR  PROTONS 

IJ  PmOTOCURPENT 

i*  surface  resistivity 

15  SPACE  01 SCHAPGE  P0T«C 

18  Internal  0  ischa rgepo t *l 

IT  »A0N  INOLCEaCCNG’YCOEFFT 

18  “ACN  INOUCEOCONO 'YROfcf P 

19  CENSirr 

20 


Input  value 
4.:o*C32  inonej 
1.27-226  »ETERS 
1.3C-G14  MHC/M 
1.00*001  (NONE) 
2.90*000  I  NONE ) 
<*00-001  *EV 
1.16*002  ANG. 

». 10-031  (NONE  ) 
1.83*002  ang. 
l.86*C30  (NONE) 
* • 55 -C 3 l  (NONE) 
l.1* 0*002  *£ V 
2.23-C;5  A/***E 
l  .32 »C 19  Oh* S 
t.jC*30*  VOLTS 
...20*023  VOLTS 
l. 32-013  *h  0  M  S  3 
1.20*CJC  (NONE) 
i.0C*0C3  “G/"*3 
2.20*001 


CODE  value 
*.22*222  (NONE ) 
1 . 2 T-OU  3  -ES« 

1.20- C1<*  “H0/» 
1.20*031  (NONE) 
1.96*301  (NONE) 

2.21- 002  AnG-01 
9.92*331  ANG. 
3.91*CC2  ANG. 
8.10-301  (NONE) 
l.a6»JC0  (NONE) 
*  •  5  5 -C  2 !  (NONE) 
1  •  *3*332  *  E  V 

2 • 33-205  A/"**2 
8  .c  5  *226  V- S/C 
1.22*229  VOLTS 
2.23*323  VOLTS 
1.23-213  *hO*S3 
1.03*322  (NONE) 
1.23*C23  96/9*2 
1.33-019 


\  ‘.V. 

2  V  V 

V  I  «L  * 


>.v: 

■  -• 


•-  .V. 


.  ^ 

££ 

v  **'  *. 

V  " 

rn  w  m  w  m 


•A: 


iT^.H 

V.Nj 

•ASs 

r  «i 


*-  -4 


TABLE  6/6 

KATE RIAL  PROPERTIES  (Continued) 


NATEPIAl  11s  sol* 

PROPERTY  input  value  coge  value 

1  DIELECTRIC  CONSTANT  2.»C»OCO  I NONr  >  3.33*330  InONE) 


2 

THICKNESS 

1.7  9-004 

-ETEPS 

1.79-033 

-ESh 

3 

CONDUCTIVITY 

1 . 33 -Cl  7 

»K0/“ 

1  «  *j  C  * C  1  7 

*hO/“ 

4 

ATOPIC  NUnSER 

l.DO^Cl 

(NONE ) 

l.JO*CQl 

(NONE  ) 

$ 

DELTA  TAX  >C3EpF 

2.3S*C30 

(NONE) 

1.31*031 

t  NGN t  ) 

6 

E-ha x  >OEPTrt««-l 

4.1C-001 

*£V 

3.17-032 

ANG-01 

7 

RANGE 

7.7**031 

ANG  . 

3 .4*9*03 ! 

ANG. 

3 

Exponent  >  range 

4. SC-001 

INCNE ) 

2.7C*C32 

ANG. 

9 

Range  >  exponent 

l.S6*C32 

ANG  . 

». 53-031 

1  NOnc 1 

0 

EXPONENT 

1.72*330 

•  NONE ) 

1.73*030 

( NONE ) 

1 

YIElC  FOR  IKEV  PROTONS 

2 .44— CGI 

(NONE ) 

C.  44-031 

( NONE ) 

z 

*AX  OE/OX  FOR  PROTONS 

2.20*032 

KEv 

2 • go  *£2  2 

«ev 

y 

PhOTOCURREnT 

2.  DC-035 

A/“»»2 

2.03-3C* 

L  /  * 

<4 

surface  resistivity 

D.DC'O 19 

OH“S 

9«d50S6 

w-s/ : 

5 

SPACE  DISCHARGE  ® o t • l 

:  .or*cc«» 

VOLTS 

1 .30*034 

VOLTS 

b 

Internal  o  ischargepot *l 

2.30*003 

VOLTS 

2 • DC  *  DC  ! 

VOLTS 

7 

RAOn  INOuCEOCONO* yCJEFFT 

1. DC-012 

HH0NS2 

1 .DC-C1 7 

»hC“S3 

a 

PaoN  INOUCEOCONO'YPO.E® 

D  .33*000 

(NONE > 

1.30* COD 

incnE ) 

9 

OEnSITy 

1.3C-CD2 

kG /»• 3 

l.uC-OO' 

kC/**S 

0 

2.3C»0il 

1. DC-017 

naTEPIAl  12:  TEFL 


PROPERTY 

1  OIElEcTPIC  CONSTANT 

2  thickness 

3  CONDUCTIVITY 

4  ATONIC  NUN8CP 

5  DELTA  NAS  >C  0£FF 

b  E-"AX  >OEPTh»*-1 

T  RANGE 

a  Exponent  >  range 

9  PANSC  >  EXPONENT 

0  EXPONENT 

1  yield  fop  ikEv  ppotons 

2  NXX  OE/OX  FOP  PPOTONS 

3  PhOTOCuHPENT 

4  SuPFACE  “ESISTIVITY 

5  SPACE  DISCHARGE  POT'L 

6  INTERNAL  0  ISCHAPGEPOT *L 

7  PA  Cn  INOUCEJCONG’yCOEFFT 

8  P  A  0  N  I«iOUCEDC3NO'YPOt.£R 

9  DENSITY 

:o 


INPUT  value  CCCE  value 

c.dc*ccc  t ncne )  c.dd*o;c  incnei 

1.2T -C34  P£T£PS  I. 27-031  "ESri 

l.CC-Clb  “MC/H  1.3R-C16  -MO/» 

7.33*000  f  NONE  )  7.30*030  IN0NE» 

3.00*000  l  NONE  )  2.2  7  »CC  I  (NONE  l 

3  .  DC -CD  1  KEV  3.53-OCO  *NG-'*1 

4.S«*CCI  ANG.  l.al*C31  *NG. 

-.JC— SOI  INCNE)  2.65*CDC  ANG. 

2. 13*032  ANG.  4.DD-7C1  INONE) 

1.77*030  ( NONE  I  1.77*C3C  (NONE) 

4.S5-0G1  (NONE)  4.55-C31  (NONE) 

1 .40*032  kEv  l . h  0  *002  KEY 

2.30-035  */**»»2  2.33-OQ*  a/h«»2 

l.oo-oifc  ohhs  a.ss.coi  v-s/a 

i.3C*C3»  VOLTS  1 . CD  *00“  VOLTS 

2.30*033  VOLTS  2.33*033  VDLIS 

l. DC-013  »H0HS3  1. 30-013  “H0HS3 

1.20*003  INCNE)  ,.D3*30C  (NONE) 

l.:c*'-31  KG  /  **•  3  i  •  DC  *03  3  *G/h*3 

2.30*031  :. DC-016 


TABLE  6/6 

MATERIAL  PROPERTIES  (Concluded) 


4AT£PIAL  13:  S  IL  V 
PPQPEPTY 

OIElECTPIC  CONSTANT 

thickness 

CONOUCTIVI Ty 
ATOMIC  NUHSEP 
DELTA  *AX  >CO£PP 
£-pax  >OEPtH«»-l 

oange 

EXPONENT  )  PANGE 

PAnGE  >  EXPONENT 
EXPONENT 

yIElC  POP  l*£v  PPOTONS 
hax  CE/O*  pop  PPOTONS 
PHCTOCuPPENT 
SoPpXCE  RESISTIVITY 
SPACE  OISCMaOGE  POT'L 
INTERNAL  OISCMAPGtPQT*!. 
PA CN  INOUCEGCONG’YCOEFPT 
p  A  ON  ^OUCEDCONG’YPOntP 
DENSITY 


INPUT  VALUE 
i.33*CCC  (NONE) 
1.0C-Q03  »*ETE9S 
-1.00*300  **hO/H 
V  .  7C.CG1  INCNE ) 

i.cs*oco  (none) 

8.30-001  KEV 
8.45*001  ANG. 
9.20-031  (NONE) 
7.94.0G1  AnC. 

1 . 74*003  (NONE) 
4. PC-031  INCNE) 
1.21*302  *E  v 
2.90-C35  A /»••! 
-1.2C»03C  OHPS 
1.3C*C04  VCLTS 
2.33*00!  VOLTS 
1.3C-C13  "M0«S3 
1.30*003  (NONE  I 
1.30*33!  *G/4»3 
2.03*031 


6.1-56 


200E  VALUE 
i. 03*000  (NONE) 
1.00-032  pESm 
-1.00*030  "HO/-. 
4.73*031  (NONE) 
3.3  9*000  (NONE) 
i. S8-002  ANG-C1 
4.93*001  ANG. 
1.38*032  ANC. 
8.23 -CO  1  INCNE) 
l.Tu*C3C  (NONE) 
4.90-031  INONE) 
1.21*032  »  E  V 
2.93-'’CE  *  /“  4»2 
-0.85—31!  V-S/C 
1.33*3C»  VOLTS 
3.33*00!  VCLTS 
1.33-01!  4H01SI 
1. .3*033  (NONE) 
1 . 33*03!  «6/ -»3 
-1.30*030 


<44 

l  *  M  ™  fcJ 


*• 

1 
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If  a  material  called  'GOLD'  or  ' GOLDPD '  or  ' GOLDXXXX '  is  defined  later 
with  different  properties  the  number  of  materials  POLAR  thinks  it  has 
will  be  increased  by  one,  but  the  new  properties  will  be  effectively 
ignored.  Multiple  definition  of  materials  should  be  avoided.  Note, 
however,  that  if  any  of  the  default  materials  are  explicitly  defined 
before  they  are  referred  to  in  building  block  definitions  then  POLAR 
will  make  no  attempt  to  find  them  in  the  list  of  default  materials  ano 
the  materials  will  not  be  multiple  defined. 

6.13  THE  OBJECT  DEFINITION  FILE  -  ANOTHER  EXAMPLE 

We  are  now  ready  to  bring  together  Sections  6.10-6.12  and 
examine  the  structure  of  the  object  definition  file.  The  general  form 
is  shown  in  Figure  6/17.  The  materials  are  defined  first,  followed  by 
the  building  blocks  associated  with  each  separate  conductor.  The  use 
of  COMMENT  cards  allow  the  logic  of  the  definition  of  a  complex  object 

w 

to  be  followed  more  easily.  Finally  the  whole  f "» le  is  terminated  with  ; 

an  'ENDSAT'  statement.  An  actual  example  is  shown  in  Figure  6 / IS .  It 
consists  of  a  central  RECTANgular  body  connected  to  two  QSPHERES  at  I 

the  ends.  ; 

A  30-VIEW  (6.20)  of  the  object  produced  by  VEHICL  is  shown  in  [ 

Figure  6/19.  ‘ 


1 ( COMMENT  WORKED  EXAMPLE  (SECTION  6.13) 

2 * COMMENT  MATERIAL  DEFINITIONS 

3 > COMMENT  FOR  PRESENT  PURPOSES.  ALL  PROPERTIES  ARE  'KAPTON 

4 (COMMENT  EXCEPT  THICKER 

SiTKAP 

6 1  3. S..  91.1.E- 16. S., 2.1, .15,71.48. .60, 

7:  312.1.1.77, .455,140., .90902.1. £♦ 16.1.E+4, 2. E+3. 

Si  1.E-13.1..1.E+3.29. 

9i COMMENT  USE  DEFAULT  KAPTON  AND  SOLD  UALUCS 
10i COMMENT  OEFINE  THE  MAIN  BODV  AND  TOP  SPHERE  TO  BE  ON 
1 1 : CONDUCTOR  1 
12IC0MMENT  MAIN  CUBOID  BODV 
13IRECTAN 

14 (CORNER  -1  -1  -2 
IS i DELTAS  334 
16 (SURFACE  «X  GOLD 
17 ( SURFACE  -X  KAPTOM 
18 (SURFACE  -V  KAPTON 
19 i SURF ACE  *V  KAPTON 
291  SURFACE  -Z  KAPTON 
21 (SURFACE  *Z  TKAP 
22>£ND0BJ 

23 i COMMENT  TKAP  SPHERE  OM  TOP 

24IQSPHERE 

2S (CENTER  993 

26 (DIAMETER  3 

27 i SIDE  1 

28«MATERIAL  TKAP 

29(END0BJ 

39 i COMMENT  PUT  THE  BOTTOM  SPHERE  OM  CONDUCTOR  2 
31 (CONDUCTOR  2 
32 i OSPHERE 
33 1  CENTER  9  9-4 
34 ( DIAMETER  3 
35ISIDE  1 
36 (MATERIAL  GOLD 
37IEND0BJ 
38 i ENDS AT 
EOF ( 38 
90 


Figure  6/18.  Object  definition  file 


6.14  OBJECTS  WITHIN  OBJECTS:  VARIEGATED  SURFACES 


POLAR  irakes  it  easy  to  define  surface:  that  are  inade  up  of  more 
than  one  material.  For  example,  we  may  want  to  define  one  face  of  a 
cube  to  be  mainly  KAPTON  but  with  a  patch  of  say  GOLD  in  the  center 
(Figure  6/20).  We  begin  by  defining  the  cube  with  a  KAPTON  face.  The 
center  surface  cell  is  then  replaced  with  GOLD  by  defining  a  second 
smaller  cube  inside  the  first  cube.  The  second  cube  is  defined  so 
that  one  of  its  faces  is  coincident  with  the  KAPTON  face.  The  surface 
common  to  both  cubes  is  then  associated  with  the  material  on  the  face 
of  the  second  cube,  which  in  this  case  is  GOLD.  This  is  shown  in 
Figure  6/20. 

The  object  definition  file  associated  with  this  object  has  the 

form: 


COMMENT 

VARIEGATED 

RECTAN 

CORNER 

-2 

-2  -2 

DELTAS 

3 

3  3 

SURFACE 

+x 

KAPTON 

SURFACE 

-X 

KAPTON 

SURFACE 

+y 

KAPTON 

SURFACE 

-y 

KAPTON 

SURFACE 

u 

KAPTON 

SURFACE 

-i 

KAPTON 

ENDOBJ 

RECTAN 

-l 

-1  -1 

CORNER 

DELTA 

l 

1  1 

SURFACE 

-z 

GOLD 

ENDOEJ 

ENDSAT 

6.1-62 


The  same  principle  can  be  applied  to  any  of  the  building 
blocks.  Exposed  surface  cells  common  to  two  or  more  building  blocks 
are  assigned  to  the  material  of  the  most  recently  defined  block. 

Two  special  building  blocks  are  supplied  specifically  to  create 
variegated  surfaces.  PATCHR  and  PATCHW  define  a  RECTAN  (cuboid)  and  a 
WEDGE  respectively,  that  may  be  used  to  "patch"  other  objects  without 
adding  to  POLAR's  list  of  filled  space.  The  use  of  actual  RECTAN  and 
WEDGE  blocks  inside  others  is  also  perfectly  legitimate,  but  adds  to 
the  internally  used  surface  list.  The  use  of  PATCHR  and  PATCHW 
reduces  the  likelihood  of  a  problem  occurring  due  to  the  list 
overflowing. 

The  object  shown  in  Figure  6/20  could  also  be  defined  using 
PATCHR: 


COMMENT  VARIEGATED  CUBE  (PATCHR) 
RECTAN 

CORNER  -2  -2  -2 

DELTAS  333 

SURFACE  +X  KAPTON 

SURFACE  -X  KAPTON 

SURFACE  +Y  KAPTON 

SURFACE  -Y  KAPTON 

SURFACE  +Z  KAPTON 

SURFACE  -Z  KAPTON 

ENDOEJ 
PATCHR 

CORNER  -1  -1  -1 

DELTAS  1  1  1 

SURFACE  -Z  GOLD 

ENDOBJ 
ENDSAT 


6.20  VEHICL 


The  VEHICL  module  is  used  to  interpret  the  object  definition 
file  (Section  6.10)  in  order  to  create  the  various  tables  and  lists 
necessary  for  the  other  modules  (Sections  5.23-5.25).  It  also  can 
produce  two  separate  kinds  of  object  plots.  By  using  appropriate 
keywords,  either  material  or  perspective  plots  are  produced  after  the 
object  file  passes  through  the  initial  definition  processing. 

When  using  keyword  inputs,  each  line  (or  card)  is  expected  to 
contain  one  keyword  followed  by  its  list  of  parameters.  After  the 
keyword  and  parameters  have  been  completely  defined,  the  rest  of  the 
line  is  ignored.  Several  characters  are  ignored  by  the  input 
routines,  namely  extra  blanks  between  words  (though  some  type  of 
delimeter  is  necessary),  equal  signs  (=),  and  commas  (,).  All  input 
is  read  using  free  formatting  with  lower  case  characters  being 
converted  to  upper  case,  and  real  numbers  may  be  entered  as  integers. 

VEHICL  will  need  the  following  permanent  files:  2.  (for 
graphics  output),  11.  (RSIO),  19.  (KSIO),  and  20.  (the  object 
definition  file,  used  as  input).  The  following  temporary  scratch 
files  will  also  be  required:  3.,  14.,  17.,  18.,  21.,  and  27..  All  of 
these  files  should  be  assigned  with  large  storage  limits. 

6.21  VEHICL  KEYWORDS 

The  specialized  VEHICL  keywords  fall  into  three  general 
categories;  object  definition,  graphical  output,  and  diagnostic  output 
control.  (See  Table  6.21/1  for  a  brief  summary  of  the  keywords.)  The 
diagnostic  keyworas  are  Described  in  detail  in  Section  6.22. 
Additionally,  all  of  the  general  POLAR  keywords  (Section  6.70),  except 
SELECT,  are  recognized  by  the  input  routines.  SELECT  cannot  be  used 
by  VEHICL  because  the  grid  information  needed  by  the  subroutine,  1^606 
(5.30),  is  not  necessarily  well  defined. 


If  an  unrecognized  keyword  or  an  invalid  use  of  a  keyword  is 
discovered,  VEHICL  issues  a  warning  or  an  error  message  then 
terminates  batch  runs  or  reads  the  next  input  in  the  case  of 
interactive  runs.  By  default,  VEHICL  believes  it  is  being  run 
interactively.  The  keyword  BATCH  (see  Section  6.70)  will  place  VEHICL 
in  its  batch  input  mode. 

The  recognized  keywords  which  control  the  object  and  grid 
definition  are: 

NXYZ 

NXYZ  defines  the  size  of  the  object  grid.  This  keyword 
absolutely  must  be  defined  for  each  execution  of  VEHICL  since  there 
are  no  default  values  for  grid  dimensions.  The  run  will 
unconditionally  abort  in  the  absence  of  this  keyword.  An  example  of 
the  use  of  the  keyword  is 

NXYZ  6  7  8 

This  defines  an  object  grid  which  has  six  nodes  in  the  X-direction, 
seven  nodes  along  the  Y  axis,  and  eight  on  the  Z  edge  of  the  grid. 

Note  that  these  numbers  are  in  nodes,  not  elements.  So  a  1  x  1  x  1 
cube  would  require  a  grid  of  at  least  4x4x4  since  object  itself  is 
2x2x2  nodes  and  none  of  the  object's  vertices  are  allowed  to  touch 
the  grid  boundary.  In  general,  extra  space  around  the  object  is  a 
good  idea,  especially  if  the  object  is  centered  asymmetrical ly  in  the 
grid  and  the  object  may  be  reoriented  within  the  object  grid  later 
using  ORIENT  (6.30).  These  problems  can  also  be  avoided  if  an  odd 
number  of  nodes  along  each  axis  are  used.  For  more  information 
concerning  the  declaration  of  object  grid  size,  please  see  Section 
6.10. 

DXMESH 

DXMESH  defines  grid  size  in  meters.  For  example, 

DXMESH  =2.0 

would  define  a  grid  spacing  of  two  meters,  while 

DXMESH  .01 


sets  the  spacing  to  one  centimeter.  The  default  value  is  one  rreter. 
This  size  may  be  easily  changed  later  during  NTERAK. 

PREFIX 

PREFIX  is  used  to  declare  the  object  file  name  for  the  UNIVAC 
version  of  POLAR.  The  CYBER  version  expects  the  object  definition  to 
be  located  in  file  2Q,  so  the  PREFIX  keyword  is  not  needed. 

In  the  UNIVAC  version,  VEHICL  must  know  the  file's  name  in  order 
to  be  able  to  find  the  input.  If  this  keyword  is  omitted  in  the 
UNIVAC  version,  VEHICL  will  terminate  with  an  error  message.  As  an 
example, 

PREFIX  MICRO 

causes  VEHICL  to  read  from  the  file  KICROOBJ.  Note  the  suffix  OBJ 
must  be  used  in  all  object  file  names.  There  is  no  default  value  for 
this  keyword. 

GRAPHICAL  OUTPUT  CONTROL  KEYWORDS 

MATPLOTS 

The  keyword  MATPLOTS  controls  the  plotting  of  material  plots. 
Material  plots  consist  of  six  views  of  the  object  from  each  direction 
of  all  three  axes.  The  surfaces  of  the  satellite  are  filled  in  with 
different  patterns  depending  on  their  material  type.  It  should  be 
noted  only  VEHICL  can  produce  material  plots,  SHONTL  is  not  able  to 
duplicate  them,  although  it  can  draw  the  same  views  without  surface 
material  patterns. 

To  control  this  feature,  use 
MATPLOTS  YES 
to  turn  it  on  and 
MATPLOTS  NO 

to  turn  it  off.  By  default,  no  material  plots  will  be  createc. 


The  graphical  output  created  by  VEHICL  is  written  on  file  2,  and 
needs  to  be  interpreted  by  the  post-processor  graphics  package  (see 
Section  6.6).  On  the  UNIVAC,  this  can  be  done  automatically  by  using 
the  PLOTDEST  keyword  described  below. 

MAKEPLOT 

MAKEPLOT  controls  the  creation  of  perspective  plots. 

Perspective  plots  are  views  of  the  object  as  seen  from  infinity  along 
a  user  defined  vector.  Both  hidden  line  and  transparent  object 
drawings  are  produced.  These  views  only  can  be  drawn  by  VEHICL; 

SHONTL  is  not  able  to  generate  them. 

The  keyword  MAKEPLOT  tells  VEHICL  how  many  views  to  expect.  The 
actual  viewing  directions  are  defined  using  the  PLOTDIR  keyword 
described  below.  To  set  the  number  of  views,  use 
MAKEPLOT  N 

where  N  is  an  integer  front  0  to  8.  A  default  set  of  views  (along  each 
direction  of  all  three  axes)  can  be  requested  using 
MAKEPLOT  DEFAULT 
or  just 

MAKEPLOT 

In  both  cases,  PLOTDIR  does  not  need  to  be  used  to  aefine  the  views. 

If  no  perspective  plots  are  desired, 

MAKEPLOT  0 

will  disable  this  feature.  VEHICL  by  default  will  not  make 
perspective  plots. 

The  graphical  output  created  by  this  command  will  be  saved  on 
file  2  and  can  be  interpreted  by  the  graphics  post-processor  described 
in  Section  6.6.  On  the  UNIVAC  this  may  be  done  automatically  by  using 
the  PLOTDEST  command  described  below. 
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PLOTDIR 


PLOTDIR  is  used  to  define  viewing  vectors  for  perspective 
plots.  Each  use  of  PLOTDIR  describes  one  of  the  views  from  infinity 
requested  by  the  MAKEPLOT  keyword  described  above.  To  actually 
produce  a  plot,  MAKEPLOT  must  be  used.  An  example  of  the  use  of 
PLOTDIR  is 

PLOTDIR  -2.  +1.5  -1. 

/V  A  A 

would  be  a  view  along  -2.0i  +  1.5j  -  1.0k  from  infinity.  Default 
directions  can  be  defined  with  the  KAKEPLOT  keyword. 

PLOTDEST 

The  keyword  PLOTDEST  is  used  to  draw  the  plots  created  using  the 
MATPLOTS  or  MAKEPLOT  keywords  described  above  immediately  after  VEHICL 
completes  its  execution.  The  keyword  is  only  functional  in  the  UhlVAC 
version  of  POLAR.  Of  course,  it  is  always  possible  to  draw  the  plots 
using  the  graphics  post-processor  (Section  6.6). 
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In  the  S-CUBED  UNIVAC  version  of  POLAR,  several  plotting  devices 
are  available.  They  are  the  electrostatic  plotter,  the  Calcomp  ana 
the  Tektronix  4014.  To  automatically  draw  plots  on  the  later  device, 
one  must  run  VEHICL  from  the  Tektronix  where  the  plots  are  desired. 

The  general  form  of  the  PLOTDEST  command  is 
PLOTDEST  destination 

where  destination  can  be  blank,  NONE,  CALC  (for  Calcomp),  ELEC  (for 
electrostataic)  and  TEKT  (for  Tektronix  4014).  Leaving  the 
destination  blank  or  using  NONE  results  in  no  plots  being  drawn  at  the 
conclusion  of  VEHICL  (again  the  post-processor  still  can  be  used); 
this  is  the  default  condition. 

OTHER  VEHICL  KEYWORDS 

The  following  keywords  are  useful,  or  necessary,  when  running 
VEHICL.  They  are  also  described  in  Section  6.7. 
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BATCH 


This  keyword  causes  the  input  to  be  read  in  a  batch  mode.  The 
main  effect  will  be  felt  when  erroneous  input  is  discovered.  If  this 
occurs  while  in  the  batch  mode,  VEHICL  will  abort  with  an  appropriate 
message.  The  default  input  mode  for  VEHICL  is  interactive  (see 
description  of  INTERACT  below).  An  example  is 
BATCH 

which  places  the  input  routines  in  their  batch  input  modes. 

COMMENT 

See  description  of  REMARK  below.  The  two  keywords  are 
equivalent. 

DEFAULT 

DEFAULT  sets  the  VEHICL  default  values.  In  general,  the 
defaults  are  for  no  diagnostic  output,  no  plots,  a  grid  spacing  of 
1  meter,  and  an  interactive  input  mode.  The  keyword  DEFAULTS  is 
equivalent  to  DEFAULT.  An  example  is 
DEFAULT 

VEHICL  automatically  calls  the  default  routine  before  soliciting 
input.  This  keyword  is  most  usedful  when  using  the  interactive  mcde 
and  the  previous  input  has  not  been  satisfactory,  or  in  error. 


The  keyword  END  is  used  to  signify  the  end  of  input  to  VEHICL. 
This  keyword  should  always  be  used  at  the  end  of  a  runstream,  but  if 
an  EOF  (end-of-f ile)  is  encountered  instead,  VEHICL  will  still 
function  normally. 
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An  example  is 
END 

No  more  input  will  be  read  at  this  point  and  VEHICL  will  begin 
operation. 

INTERACT 

The  INTERACT  keyword  is  used  to  place  the  VEHICL  input  routines 
in  an  interactive  mode.  This  means  that  any  errors  encountered  in  the 
input  runstream  will  generate  an  appropriate  error  or  warning  but  will 
not  cause  VEHICL  to  terminate  its  execution.  This  is  the  default  mode 
of  input  for  VEHICL.  To  abort  on  the  discovery  of  bad  input,  use  the 
BATCH  command  described  above.  An  example  of  the  use  of  the  keyword  is 
INTERACT 

which  will  place  VEHICL  in  an  interactive  input  mode. 

REMARK 


This  keyword  is  used  to  insert  comments  in  a  runstream.  When  a 
REMARK  is  encountered,  the  remainder  of  the  input  card  will  be  ignored 
and  a  new  card  will  be  read.  Any  number  of  REKARKs  may  be  usea.  An 
example  of  the  use  of  the  REMARK  keyword  is 
REMARK  THIS  IS  A  REMARK 

All  of  the  data  on  the  card  following  the  first  REMARK  will  be 
ignored.  The  keyword  COMMENT  (mentioned  earlier)  can  be  substituted 
for  REMARK  and  is  completely  equivalent,  for  example, 

COMMENT  THIS  IS  A  REMARK  TOO. 

And  again,  everything  on  the  card  which  follows  COMMENT  will  be 
ignored. 
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TABLE  6.21/1 

SUMMARY  OF  THE  VEHICL  KEYWORDS 


BATCH  Places  VEHICL  input  routines  in  a  batch 

input  mode.  The  default  mode  is 
interactive.  (See  INTERACT.) 

COMMENT  text  Causes  text  to  be  ignored  by  the  input 

routines.  Text  may  be  any  set  of 
characters  and  numbers. 

DEFAULT  Resets  options  to  default  values.  Called 

DEFAULTS  automatically  at  beginning  of  VEHICL. 

DXMESH  length  Defines  grid  spacing.  Length  is  the  grid 

spacing  in  meters.  Default  is  1  meter. 

END  Makes  the  end  of  the  VEHICL  input. 

Should  be  included  at  the  end  of  all 
runstreams. 

INTERACT  Places  VEHICL  input  routines  in  their 

interactive  input  rrioaes.  This  is  the 
default  mode.  (See  also  BATCH.) 

MAKEPLOT  option  Controls  number  of  perspective  plots. 

Valid  options  are  DEFAULT  (proauces  6 
default  viewing  directions)  or  an  integer 
from  0  to  8.  The  default  option  is  0. 

MAKEPLOTS  option  Control  material  plot  production.  Valia 

options  are  YES  and  NO.  The  default  is 
NO. 

NXYZ  ix  iy  iz  Defines  object  grid  size,  where  ix,  iy, 

and  iz  are  integers  defining  the  number 
of  nodes  in  the  x,  y  and  z  directions, 
respectively.  This  keyword  must  be 
included  in  all  VEHICL  runstreams. 

PREFIX  name  Defines  the  file  name  containing  the 

object  definition.  If  the  file  name  is 
CUBEOBJ,  name  would  be  replaced  by  CUBE. 
(Keyword  applies  to  UNIVAC  only.) 

PLOTDEST  option  Controls  where  plots  are  drawn  at  end  of 

a  VEHICL  run  (UNIVAC  only).  Valid 
options  are  blanks,  NONE,  CALC,  ELEC,  and 
TEKT.  The  oefault  is  NONE. 

PL0TD1R  x  y  z  Describes  viewing  direction,  from 

infinity,  used  to  draw  a  perspective  plot. 

REMARK  text  Causes  text  to  be  ignored  by  the  input 

routines.  Text  may  be  any  set  of 
characters  and  numbers. 
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6.22  VEHICL  DIAGNOSTIC  KEYWORDS 
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There  are  several  levels  of  diagnostic  output  available  from 
VEHICL  by  keyword  instructions.  None  of  it  is  of  interest  to  the 
casual  user  and  is  mainly  a  remnant  of  the  code  development  process. 
But  sometimes  errors,  code  modifications  or  just  idle  curiosity  will 
require  some  of  VEHICL's  diagnostic  output.  By  default,  all  VEHICL 
output  flags  will  be  turned  off  or  set  to  the  lowest  possible  values. 


I  The  following  is  a  description  of  the  appropriate  diagnostic 

flags  and  their  settings. 

DIAG  General  VEHICL  Output 

=0  No  output. 

=1  A  few  crucial  tidbits  from  the  construction  of 

the  A-2,  KSURF,  LCEL,  and  LTBL  lists. 

-2  More  details  concerning  the  construction  of 

the  various  lists. 

=3  Still  more  information. 

I  =4  Provides  a  great  amount  of  details  concerning 

[  VEHICL's  actions. 


IDIAGS(l) 

OCVCEL 

Information 

=0, 

1,  2,  3 

No  output. 

=4 

Output  from  DCVCEL  during  the  creation  of  the 
SREL  list.  Also,  information  from  the  various 
VCUBE  routines. 

=5 

Additional  DCVCEL  data. 

I D I AGS ( 2 ) 

CBUF  Data  Management 

=0, 

1 

Nothing. 

=2 

Output  from  BUFSET. 

=3 

Output  from  PAGER. 

=4  All  of  the  information  from  PAGER  and  GRIDIO. 
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JDIAGS(l)  SREL  Information 

«0,  1  No  output. 

m2  Print  out  LCEL  and  SREL  lists.  Also 

information  from  RECELL,  SREL  index  to  LCEL. 


*3  Print  out  preliminary  LCEL  list. 

=4  Detailed  output  from  routines  constructing 

LCEL  and  SREL  lists. 


JDI AGS ( 5 ) 
=0, 
=3 
=4 

JDIAGS(9) 

<4 

=4 

KDIAGS(l) 

=1 

=2 


Double  Point  Data 
1,  2  Nothing. 

Double  point  locations  from  SPDPNT. 

More  double  point  information  from  SPDPNT. 
MTLGEN  Information 

No  information. 

Material  properties  and  final  PSGN:  matrix. 
NiSIO  information  ( UNI  VAC  only) 

PSIO  routines  echo  calls  to  themselves. 
Perform  tracebacks  when  called. 


OBJPRT  level 

HIDPRT  level 

IOGRID  level 


Output  from  initial  object  definition 
routines.  Acceptable  level  keywords  are  NO, 
SOtfE  or  ALL. 

Output  from  hidden  line  routine,  HIDCEL. 

Valid  level  keywords  are  YES  and  NO.  Note 
that  YES  will  generate  a  vast  amount  of  output. 

Grid  information.  Valid  level  keywords  are 
YES  and  NO.  Currently,  this  keyword  is 
deactivated. 


In  addition,  several  diagnostic  flags  were  used  which  produced 
about  2000  lines  of  unnecessary  output. 

The  grid  was  chosen  to  comfortably  hold  the  object.  If  this 
object  had  been  defined  to  be  run  later  using  NTERAK,  the  grid  would 
have  been  defined  with  more  care  with  respect  to  the  final  desired 
size.  It  is  best  to  keep  from  defining  a  great  deal  of  extra  space  in 
the  z-direction  (or  in  the  direction  which  becomes  the  z-direction 
after  reorientation)  to  prevent  the  needless  10  of  oversized  object 
grid  size  tables  (Section  5.3). 

6.24  TROUBLESHOOTING  VEHICL 

Usually  VEHICL  will  provide  an  explanatory  error  message  before 
it  dies.  The  most  common  fatal  error  which  currently  has  no  message 
or  at  least  an  opaque,  user  hostile  message,  is  from  DCVCEL  in 
SUREAL.  The  message,  "##### -FATAL-FROM  DCVCEL  -  ELEMENT  NUMBER  ... 

DOES  NOT  CORRESPOND  TO  LIST  ENTRY  . ",  results  from  the  grid  being 

defined  too  small  or  the  object  being  too  close  to  one  side. 

What  has  happened  is  that  somewhere  the  object  has  touched  the 
edge  of  the  object  grid.  The  cure  is  simply  to  try  again  with  a 
larger  object  grid. 

Poorly  defined  objects  or  ambiguous  double  points  also  create 
difficult  problems.  Some  useful  advice  can  be  found  in  Section  6.11. 
If  the  definition  process  has  proceeded  far  enough,  it  may  be  possible 
to  produce  material  or  perspective  plots  as  a  visual  aide  (Sections 
6.20  and  6.21).  The  SHONTL  module  may  also  be  used  to  draw  the  object 
or  to  print  out  some  of  the  list  output  which  has  been  saved  in  the 
MSIO  files  using  CBUF  storage  functions  (5.30). 


6.30  ORIENT 


In  order  that  the  object  may  be  defined  in  an  arbitrary 
direction  or  defined  once  and  used  in  several  orientations,  it  is 
necessary  to  be  able  to  automatically  reorient  the  satellite.  The 
ORIENT  module  does  this  by  rotating  both  the  object  and  the  object 
grid.  This  is  necessary  since  NTERAK  assumes  the  largest  component  of 
flow  vector  will  be  in  the  positive  Z-direction,  forcing  a  preferred 
direction  on  the  problem.  This  module  allows  the  same  object  to  be 
studied  in  any  flowing  plasma  without  redefinition.  Of  course,  if  no 
rotation  is  necessary,  OREINT  does  not  need  to  be  used. 

ORIENT  uses  as  input  files  the  K.SIO  output  files,  11  and  19, 
created  by  VEHICL.  These  files  are  also  the  output  files,  so  they 
should  be  copied  if  the  VEHICL  output  is  to  be  preserved. 

6.31  ORIENT  KEYWORDS 

In  general,  the  keywords  which  were  accepted  by  VEHICL  (6.2)  can 
be  used  in  ORIENT  since  the  two  modules  share  many  routines.  Instead 
of  redefining  VEHICL  keywords  again,  a  reference  to  the  section 
explaining  the  command  will  be  given.  The  reader  is  also  referred  to 
the  general  keyword  input  section,  6.7,  for  more  information.  Table 
6.31/1  contains  a  brief  summary  of  ORIENT  commands  for  convenience. 

The  following  is  a  description  of  the  set  of  ORIENT  keywords. 

VN'ACH 


VNACH  is  the  plasma  flow  direction  normalized  to  the  ion 
acoustic  speed.  The  entire  problem  will  be  rotated  so  that  the 
largest  component  of  VKACH  will  be  in  the  positive  z-direction.  The 
rotated  VKACH  will  be  stored  and  will  be  the  default  value  for  the 
NTERAK  module.  But  the  hach  vector  can  be  changed  later  to  any  value 
so  long  as  the  largest  component  is  still  in  the  positive  direction. 
An  example  of  the  command  is 
VIYACH  0.  C.  -8. 


This  would  cause  the  object  to  be  inverted  so  that  the  old  negative 
2-direction  becomes  the  positive  2-direction.  There  is  no  default 
value  for  this  command.  If  it  is  not  defined  ORIENT  terminates  with 
an  error  message.  (This  implies  a  default  value  of  (0.,  0.,  1.),  no 
rotation. ) 


For  a  description  of  the  following  ORIENT  keywords  see  Section 

6.21. 

BATCH 

COME  NT 

END 

INTERACT 

REMARK 

TABLE  6.31/1 

A  SUMMARY  OF  THE  ORIENT  KEYWORDS 

BATCH  Places  ORIENT  input  routines  in  a  batch 

input  mode.  The  default  mode  is 
interactive.  (See  INTERACT.) 

COMMENT  text  Causes  text  to  be  ignored  by  the  input 

routines.  Text  may  be  any  set  of 
characters  and  numbers. 

END  Marks  the  end  of  the  ORIENT  input. 

Should  be  included  at  the  end  of  all 
runstreams. 

INTERACT  Places  ORIENT  input  routines  in  their 

interactive  input  modes.  This  is  the 
default  mode.  (See  also  BATCH.) 

REMARK  text  Causes  text  to  be  ignored  by  the  input 

routines.  Text  may  be  any  set  of 
characters  and  numbers. 

VMACH  x  y  z  Defines  the  desired  orientation  by  the 

sign  and  location  of  largest  absolute 
component,  x  y  z  is  the  three  vector 
describing  the  Mach  vector  normalized  to 
the  ion  acoustic  speed.  This  keyword 
must  be  defined  for  ORIENT  to  execute. 


Diagnostic  output  from  ORIENT  is  obtainable  by  using  the  VEHICL 
diagnostic  flags  defined  by  Section  6.22. 

6.32  RUNNING  ORIENT 

After  the  VEHICL  output  files  (or  a  copy  of  them)  have  been 
assigned,  the  runstream  shown  in  Figure  6.32/1  could  be  used  to  rotate 
the  satellite  defined  by  Figure  6.1/18  and  pictured  in  Figure  6.1/19 
so  that  neither  of  the  two  spheres  point  in  the  ram  direction.  After 
execution,  the  reoriented  object  can  be  viewed  using  the  SHONTL  module 
to  see  where  in  the  grid  the  object  ended  up. 

@XCT  ORIENT 

BATCH 

RENARK  ROTATE  FIGURE  6.1/19  TO  BE 

RE  HAFT  S  ICEWAYS 

•  HA  -i.  C.  0. 

FIHAFK  "THAT  WAS 

E  r,[ 

Figure  6.32/1  Sample  ORIENT  runstream. 

Because  the  exact  center  of  the  grid  is  not  necessarily  on  a 
node,  the  object  may  move  a  grid  space  in  one  (or  more)  directions. 
This  can  cause  ORIENT  to  find  an  error  during  the  SREL  list  creating. 
The  error  is  due  to  the  object  touching  the  object  grid  boundary  at 
some  point.  As  previously  mentioned  (6.24),  this  error  is  cured  by 
expanding  the  object  grid.  Unfortunately,  only  VEHICL  can  do  this. 

So  object  must  first  be  redefined  in  a  larger  grid  by  VEHICL,  then 
rotated  by  VEHICL.  It  is  a  good  practice  to  add  an  extra  node  on  all 
sides  of  the  grid  if  reasonable  when  an  object  is  to  be  rotated. 


An  even  better  solution  is  to  use  an  odd  number  of  nodes  along 
each  axis.  Then  the  center  of  the  grid  will  fall  on  a  node  and  the 
object  should  not  touch  the  grid  boundary  in  ORIENT  if  it  did  not  in 
VEHICL. 


6.4-1 


6.45.  SUMMARY  OF  NTERAK  KEYWORDS 

NTERAK  is  the  program  that  calculates  the  plasma  interaction  and 
vehicle  charging.  Its  keyword  control  language  has  both  'verbs’  and 
'noun ’-options.  A  run-language  sentence  is  constructed  in  the 
reverse-Polish  sense,  i.e.,  nouns  first,  verbs  last.  The  NTERAK  verbs 
are: 

PWASON  -  invokes  the  Poisson  solution 

CURREN  -  invokes  the  sheath  particle  tracking 

CHARGE  -  invokes  the  circuit  model  update  of  surface  potentials 

ENDRUN  -  run  finished 

The  following  is  a  list  of  the  NTERAK  keyword  options.  The 
first  column  is  the  keyword,  the  second  column  lists  the  possible 
responses.  Literal  options  are  listed  with  the  default  underlined. 
Numerical  responses  are  indicated  by  the  default  value  in  parentheses 
followed  by  the  variable  type  I,  for  integer;  F,  for  floating  point 
real  number,  E,  for  exponent  type,  i.e.,  1.2E12,  and  L,  for  literal 
(no  quotes). 


6.4-2 


OPTION 

BATCH 

THTCITact 


DEFAULTS 
I  START 


VALUE,  FORMAT 


EXPLANATION 


IGICAL 


SAVSET 


GISAVE 


X, L  #  ,  I 

Y, L  #,  I 

Z, L  #,  I 


Keyword  only  to  select 

operation  mode,  turn  prompts  on  or  off, 

etc.  non-critical . 

Set  or  reset  default  option. 

New  run.  Allows  for  the  calculation  of 
new  GI’s  or  the  use  of  old  ones  if  the 
computation  grids  are  identical.  Space 
potentials  will  be  zeroed,  and  a 
precharge  step  (automatic  call  to  CHARGE) 
performed  according  to  CHARGE  options  if 
requested. 

Continue  a  run,  use  old  densities. 

Ignored  when  I  START  ^  NEW. 


YES  - 


NO  - 
OLDI  - 


calculate  new  GI ’ s 
(expensive).  Default  for 
I START  =  NEW. 

Use  1.0's  everywhere. 

Use  old  DION's  from  previous 
run.  Mach  vector  and 
computational  grid  should  be 
identical.  Default  for  ISTART 
*  CONT. 

Use  old  GI’s  from  previous  run. 

Equivalent  of  IGICAL  =  NO 
overrides  IGICAL  =  YES  with 
exception  noted  by  GISAVE. 

Leave  IGICAL  =  YES  alone, 

SAVSET  can  be  switched  at 
location  indicated  by  GISAVE. 

Two  fields  following  the 
keyword.  X  4  means  that  at  all 
nodes  in  the  plane  at  X  =  4, 
the  value  of  SAVSET  will  be 
temporarily  toggled.  Up  to 
nine  planes  may  be  entered. 


The  combination  IGICAL  YES,  SAVSET  NO,  and  GISAVE  Z  -3, 
GISAVE  Z  -4,  would  cause  the  neutral  ion  density 
calculation  (GI's)  to  be  calculated  everywhere  except  at 
Z  =  -3,  and  Z  =  -4.  IGICAL  YES,  SAVSET  YES,  GISAVE  X  4, 
GISAVE  Y  5,  GISAVE  Z  12,  would  cause  GI  values  to  be 
calculated  at  the  point  4  5  12  only. 


'iJWkVtTW 


OPTION 


VALUE,  FORMAT 


EXPLANATION 


6.4-3 


EFLDCOR 

YES 

N(T 

Use  electric  field  corrections  to  the  ion 
density  calculations. 

IGIOUT 

NO 

YES 

Output  of  appropriate  densities. 

PRECHG 

PRE 

Starting  surface  potentials  from  a 
precharge  step. 

CONS 

Constant  surface  potentials.  Default  for 

I  START-NEW. 

POTVAL 

(Vh), 

E,F 

Initial  insulator  potential.  Default  is 
potential  of  conductor  1  (or  Vci). 

CONDV 

N  pot 

Initial  conductor  voltages  where  N  is  the 
conductor  number  (N=l  is  ground 
conductor)  and  pot  is  the  initial 
potential  in  volts. 

INSULPOT 

DIFF 

CONS 

Defines  POTVAL  to  be  the  initial 
DIFFerential  voltage  from  insulator 
surfaces  to  underlying  conductor  or  a 
CONStant  insulator  surface  voltage. 

FLOAT 

n 

Floats  conductor  n.  If  n  (a  conductor 
number)  is  omitted,  all  conductors  are 
floated  (the  default  condition). 

FIXP 

n  V 

Fixes  potential  of  conductor  n  to  V  volts. 

BIAS 

n  V 

Bias  potential  of  conductor  n  with 
respect  to  conductor  1  by  V  volts. 

RIJ 

i  j  r 

Sets  resistance  between  conductor  i  and 
conductor  j  to  r  ohms.  For  r  <  1 , 
infinity  (also  default)  will  be  used. 

CIJ 

i  J  c 

Sets  capacitance  between  conductor  i  and 
conductor  j  to  c  farads. 

HELP 

Output  summary  of  option. 

DXMESH 

F,E 

Grid  spacing  length  in  meters. 

NXADNT 

(0),  I 

Number  of  nodes  added  to  the  object  grid 
in  the  +X  direction  to  set  up  the 
computational  space. 

6.4-4 


OPTION 

VALUE, 

FORMAT  EXPLANATION 

NXADN6 

(0),  I 

Add  nodes  in  -X  direction. 

NYADNT 

(0),  I 

Add  nodes  in  +Y  direction. 

NYADNB 

(0),  I 

Add  nodes  in  -Y  direction. 

NZADON 

(0),  I 

Add  nodes  in  -Z  direction. 

NZTAIL 

(0),  I 

Add  nodes  in  +Z  direction  (wake). 

IOGRID 

REMARK 

COMMENT 

NO  L 

YES 

Output  grid  information. 

Comment  out.  Runstream  options. 

NPHI 

(36), I 

Number  of  zenith  angle  divisions  for  GI 
calculation. 

NTH ETA 

(180),] 

[  Number  of  azimuthal  angle  division  for 
calculation. 

NADO 

(2), I 

Add  extra  vertices  to  object  shadow  in 
velocity  space  for  GI  calculations. 

VMACH 

VX  VY  VZ,F 

Mach  vector  units  of  /kT/m.  Default  is 
set  by  VEHICL  or  ORIENT. 

DENS 

(l.OEll).E.F 

Ambient  density  in  / iP. 

TEMP 

(0.2) ,E,F 

Ambient  temperature  in  eV. 

DEN2 

(0.0), E,F 

For  energetic  Maxwellian  in  m'3. 

TEMP2 

(0.0), E,F 

For  energetic  Maxwellian  in  eV. 

POWCO 

(0)  ,E ,  F 

Power  law  coefficient  /m^.sec.str.eV. 

PALPHA 

(0) ,E ,  F 

Power  law  exponent. 

PCUTL 

(1.0E2),E,F 

Power  law  lower  cutoff,  in  eV. 

PCUTH 

( 1 .0E9) ,E,F 

Power  law  upper  cutoff,  in  eV. 

GAUCO 

(0)  ,E,F 

Gaussian  distribution  coefficient 
/mSsec.str.eV. 

ENAUT 

(0) ,F,F 

Gaussian  peak  in  eV. 

DELTA 

(0)  ,E ,  F 

e-folding  width  of  Gaussian. 

RATIH 

( 1 .0E4) ,E ,  F 

Ion  to  hydrogen  ratio. 
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OPTION 

VALUE, 

6.4-5 

FORMAT  EXPLANATION 

AMU I ON 

(16.0)  ,E,F 

Ion  mass,  in  AMU 

BMAG 

(.4),E,F 

Magnitude  of  B  field,  gauss. 

BDIR 

(-1  0  0) 

Vector  direction  of  B  field,  normalized 
by  code. 

BFIELD 

OFF  L 

W 

Turn  magnetic  field  effects  on  and  off. 

FOR  PWASON 

MAX  ITS 

(2), I 

Space  charge  iteration  limit. 

MAXITC 

(10), I 

Potential  iteration  limit. 

MINITC 

(2), I 

Potential  iteration  lower  limit. 

RDRMIN 

E,  F 

Potential  convergence  test.  The  default 
value  is  number  of  nodes  *  .0001. 

POTCON 

(6) 

=  log  10  ( RDOTR ( 1 ) / RDOTR ( v ) ) ,  potential 
convergence  test. 

IOCONG 

PART  L 

NO 

FULL 

Output  control  of  potential  calculation. 

ISPOUT 

PART  L 

LAST 

NO 

FULL 

Output  control  of  space  charge 
calculation. 

To  get  final  potentials  from  PWASON. 

PDIE 

(20*TEMP)E,F 

Maximum  allowable  positive  voltage  in 
screening  calculation. 

SQALPH 

(3),F 

Space  charge  distribution. 

6.4-6 

OPTION  VALUE,  FORMAT  EXPLANATION 


FOR  CURREN 


STHPOT 

PSIM  E,  F 

Particle  sheath  boundary  potential. 

PSIM  *  tn(SQALPH*(xD/DXMESH)^) 

NTABLE 

(10), F 

The  number  of  entries  in  the  table  used 
by  SHEATH  to  calculate  presheath  weights 

IPCNT 

(3), I 

The  maximum  number  of  left  and  right 
particle  pushing  sequences  allowed. 

CURPOT 

(-.45*TEMP) , 

E,F 

The  potential  at  which  the  presheath 
weights  are  calculated. 

FOR  CHARGE 

MAX  ITT 

(2)  I 

Number  of  timesteps. 

DELTAT 

(No  default)E,F 

Timestep,  seconds,  no  default. 

DVLIM 

(1000. )E,  F 

Voltage  change  per  step,  in  volts. 

IMPEXP 

IMPL 

EXPL 

Normal  explicit-implicit  sequence. 
Explicit  only. 

VLTFIX 

(Vp),E,F 

Estimated  potential  crossover  for 
non-charging  surfaces.  (Used  as  a 
boundary  on  calculation.)  Vp  = 
(AMUI0N*1.67xl027/9.1xl031). 

VFIXHI 

(-10000), E,F 

Estimate  of  upper  (charging  cases) 
crossover  potential.  Used  as  a  boundary 
to  try  and  limit  voltage  swings.  Volts. 

DVTEST 

(5),E,F 

Guess  used  in  first  CHARGE  cycle  for 
voltage  change  in  previous  timestep. 
Volts. 

VWIGGL 

( .001) ,E,F 

Minimum  change  forced  when  a  surface  is 
near  its  equilibrium. 

XDVFAC 

(2) ,E,F 

Multiplies  DVLIM  to  be  used  in  first 
trial  of  a  CHARGE  cycle  to  guess  the 
potential  of  the  crossover  point. 

6.4-7 

OPTION  VALUE,  FORMAT  EXPLANATION 

FOR  DIAGNOSTICS 


IDIAGS( #)  #,I  Diagnostic  and  output  controls,  see 

JDIAGS(#)  #,I  Section  6.45.10. 

KDIAGS(#)  #, I 

I BI AGS ( # )  #,I 

OUTPUT  sec  quant  Sets  a  set  of  DIAG  flags  appropriate  to 

subsection  (sec)  and  quantity  (quant). 
Valid  subsections  are  TIMER  (run  time 
information),  PWASON,  CHARGE,  CURREN,  and 
NEUDEN  (the  neutral  ion  density 
calculation).  Valid  quantities  are  HIGH, 
LOW,  and  OFF.  Defaults  are  set  to  LOW 
for  all  subsections. 

SELECT  options  Used  to  select  specific  Z-slices  from 

large  tables  for  output.  Also  can  be 
used  to  turn  output  of  a  data  set  off  (or 
on).  The  various  options  are  described 
below. 

SELECT  name  list  ENDL1ST  Name  is  a  buffered  name  (5.30)  which  is 

sliced,  list  is  a  set  of  integers 
separated  by  blanks  which  are  object  grid 
Z-slice  values  (e.g.,  to  get  IZ=2  and  3 
of  POT  say  SELECT  POT  2  3  ENDLIST) 

SELECT  name  ALL  Turns  on  or  off  output  of  name  (a  buffered 

NONE  set  of  data).  Default  is  on  (ALL). 

SELECT  LIST  n  list  ENDLIST  Defines  LIST  n  (1  <  n  <  5)  as  list  (see 

above) . 

SELECT  name  LIST  n  Prints  LIST  n  Z-slices  when  name  data  is 

printed. 


6.45.10  NTERAK  DIAGNOSTICS  AND  OUTPUT  CONTROL 

The  diagnostic  keywords  recognized  by  NTERAK  are  IDIAGS(N)  and 
JDIAGS(N).  For  example,  a  runstream  might  contain  the  card 
I DI AGS ( 9 )  1 

All  diagnostics  have  a  default  level  of  zero.  Diagnostic  flag  levels 
are  usually  recognized  in  a  >  sense;  i.e.,  larger  flag  levels  include 
all  the  lower  levels. 

The  diagnostic  flags  are  as  follows: 

IDIAGS(l)  used  by  PWASON 
=  2  CONGRD  output 
=  3  COPROD  output 

=  4  Additional  COPROD  info,  all  of  the  PCUBE  routines,  and 
DCVCEL  output 

=  5  Additional  DCVCEL  output 
I DI AGS ( 2 )  CBUF  usage 

=  2  Information  from  DEBUF,  BUFSWP,  GETLAD,  BUFSET  (MORCOR 
calls,  IAVECS  settings) 

=  3  PAGER  (TIMER  calls  on  entry  and  exit) 

=  4  All  info  from  PAGER  and  GRIDIO 

I DI AGS ( 3 )  VERTIO  check 

=  4  All  VERTIO  action 

I D I  AGS ( 4 )  TIMING 
=  1  in  OPTIN 

=  2  in  CHARGE,  IONDEN,  CONGRD 


=  3  in  PAGER 


IDIAGS(5)  Self  diagnostics 

■2  GRI0I0  (calls  CHKPUF  to  check  the  addressing  system). 
IONDEN  plus  others  possibly  in  future  (calls  CHKLOC  to 
issue  warnings  if  addresses  within  CBUF  are  too  big  to  be 
passed  within  a  word.) 

*3  CHKLOC  prints  core  locates  of  the  all  locations  passed  to 
it. 

=4  CHKLOC  generates  non-fatal  walkbacks  for  warning 
situations. 

=5  CHKLOC  generates  non-fatal  walkbacks  for  all  calls  to  it. 

IDIAGS(6)  Trajectory  tracing  (CURREN) 

=  1  Trajectory  progress  checking 

=  2  PRNTSL  (particle  reading  and  writing)  action,  particle 
movement  at  the  slice  level 

=  3  Complete  output  from  PRNTSL,  print  out  the  various  grids 
used  by  CURREN  on  exit 
=  4  Print  individual  particle  movements 

=  5  Energy  checking  diagnostics 

I DI AGS ( 7 )  QSELT 

=  4  QSELT  information 

1 01 AGS( 8 )  CHARGE 

=  0  Echo  input 

=  1  Control  flow  info 

=  2  Voltage  results  from  ICCG 

=  3  Input  to  ICCG,  previous  cycle  data,  material  info 

=  4  Intermediate  subroutine  output 

=  5  Surface  by  surface  calculations 

=  6  FLUXEL  and  FLUXBK  output,  CHKIMV  surface  checking 


ID1AGS(9)  IONCUR 

»  1  Print  SRFI  list 

.  2  Intermediate  lists 

.  3  Weight  calculation  results 

*  4  Weight  calculations 

=  5  Particle  lists  from  CURRENT 

JDIAGS(l)  SREL  (VEHICL) 

=0,1  No  output 

=  2  Print  out  LCEL  and  SREL  lists.  Also  information  from 
RECELL,  SREL  index  to  LCEL. 

=  3  Print  out  preliminary  LCEL  list 

=  4  Detailed  output  from  routines  constructing  LCEL  and  SREL 
lists. 

JDI AGS ( 2 )  SHEATH  calculation 

=  3  Print  presheath  information 

JDIAGS(3)  PRECHG 

=  2  Print  ambient  ion  currents  calculated  by  AMBCUR 
=  3  ASRF  from  ALSURF 

JDIAGS(4)  IONDEN 

=  1  Print  progress  notes 

=  3  SHFTIT  results  (for  filled  or  partially  filled  elements) 

JDI AGS ( 5 )  Double  point  data 

=  2  Potentials  from  POTSET 

=3  On  input  to  major  modules  and 

double  point  locations  from  SPDPNT  (vehicl) 

=  4  More  double  point  information  from  SPDPNT  (vehicl) 

JDI AGS{6 )  RHOI  values 

=  2  Print  RHOIs  after  completion  of  CURREN  (in  CUEXIT) 


JOI AGS ( 7 )  Particle  pushing  error  control 

=  1  Print  info  for  particle  in  error 
=  3 

=  4  Kill  run  if  5  percent  of  particles  are  lost  to  errors 

=  5  Die  instantly  when  an  error  occurs 

JDI AGS ( 8 )  Modified  CHARGE  output 

a  1  Final  surface  voltage  for  the  cycle,  including  INI  SET 

=  2  Initial  FTOT  and  FSM  used  (total  current  and  total 

secondary  current) 

=  3*  Components  of  current  for  each  surface 
*  Note  that  the  information  produced  by  JDIAGS(8)  =  2  is  included 
in  JDIAGS(8)  =  3  so  the  flags  are  exclusive. 

JDIAGS(9)  MTLGEN  (in  VEHICL) 

=  2  Print  calculated  AMAT 

=  4  Print  all  appropriate  information 

JDIAGS(9)  IONGEN  (in  NTERAK) 

=  2  IONGEN  prints  DIONs 

=  3  IONGEN  prints  LTYPs 

KDIAGS(l)  MSMODS 

=  1  Routines  echo  calls  to  themselves 
=  2  Perform  tracebacks  when  called  to  find  caller 

K0IAGS(2)  CHKSTH,  CHKTRJ 
=  3  Echo  commands 

KDIAGS(3)  E  field  correction  to  geometric  ion  densities 
=  2  Print  tables  which  will  be  used 

KDIAGS(4)  DBLCHK  (particle  validation) 

=  2  Potentials  for  rejected  particles 
=  4  Position  velocity  for  all  particles 
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6.50  OPERATING  SHONTL 

SHONTL  is  POLAR's  general  plotting  and  information  extraction 
program.  Its  primary  sources  for  these  functions  are  the  two  mass 
storage  files,  11  and  19.  For  certain  functions,  SHONTL  will  actually 
duplicate  NTERAK  calculations. 

SHONTL ‘s  primary  plotting  mode  is  to  construct  two-dimensional 
contour  plots  of  data  slices  perpendicular  to  any  of  the  three 
coordinate  axes.  Currently,  the  following  variables  may  be  viewed  in 
this  fashion:  neutral  ion  densities  ( ' GI ' s ) ,  composite  ion  densities 
(’DION's),  stabilized  charge  densities  { ' QUSD * ) ,  and  potentials 
('POT').  In  addition,  SHONTL  can  execute  the  CURREN  module  of  NTERAK 
and  superimpose  the  results  on  any  of  the  contour  plots.  In 
particular,  there  are  two  types  of  graphical  output  from 
SHONTL-CURREN.  The  sheath  location  can  be  indicated  by  a  contour  of 
X’s  using  either  the  sheath  potential  that  was  used  by  NTERAK-CURREN, 
or  optionally  changed  with  the  STHPOT  keyword  (Section  6.52);  also, 
ion  trajectories  may  be  displayed  with  the  following  options:  A  total 
perspective  of  complete  trajectories  projected  onto  the  plot’s  slice 
(keyword  PERSPC),  the  portion  of  all  trajectories  that  pass  through 
the  plot  slice,  trajectories  emanating  from  a  ring  of  sheath  points 
lying  in  selected  X-Y  plane  (X-Y  only)  (keyword  RING)  which  can  also 
use  the  PERSPC  option,  and  in  addition  to  all  of  the  above  the  WEED 
option  will  throw  out  about  75  percent  of  the  trajectories  to  reduce 
plot  cluttering  and  computing  costs.  Finally,  a  single  point 
trajectory  option  is  also  available  (keyword  SPOTS). 

Other  plotting  features  are  limited  to  a  spectrum  plot  of  the 
energetic  electron  environment.  Future  modifications  will  allow 
SHONTL  to  reproduce  the  material  plots  and  the  hidden  line  object 
perspective  views  that  are  currently  available  only  from  VEHICL. 


In  addition  to  plotting,  SHONTL  can  output  to  a  printer  (or 
whatever)  the  current  values  of  virtually  any  variable  stored  on  files 
11  and  19,  through  the  use  of  the  PRINT  NAME  keyword  where  NAME  would 
be  the  exact  FORTRAN  name  of  any  variable  known  to  MRBUF  (a 
subroutine).  A  list  of  these  can  be  found  in  Section  5.33.  The 
format  for  this  output  is  generally  identical  to  that  used  by  VEHICL, 
ORIENT,  and  NTERAK  when  these  variables  are  output  from  these 
modules.  A  note  of  warning  -  variable  aliasing  is  not  always 
identical  between  modules.  For  example,  potentials  would  be  output  by 
NTERAK  by  the  'card' 

I  SPOUT  FINAL 

which  would  produce  potential  array  output  (modified  by  the  SELECT 
keyword)  at  the  conclusion  of  a  spacecharge-potential  calculation  (the 
PWASON  submodule  of  NTERAK).  Whereas  in  SHONTL  one  would  enter  the 
cards 

SELECT  -  options  - 
PRINT  POT 

to  get  the  same  output. 

Like  the  other  modules,  SHONTL  keywords  fall  roughly  into  two 
categories  that  can  be  described  as  verbs  and  adverbs.  For  example,  a 
user  might  enter  the  following  adverb  cards  to  set  up  plot  parameters: 
PLOTS  ON 
LEVELS  20 
LEVELS  NOMARK 
GRDPTS  ON 
SHEATH  ON 

followed  by  the  verb  card 
POT  X 

which  would  trigger  the  actual  production  of  a  potential  contour  plot 
with  a  sheath  indicated,  no  contour  markings,  approximately  20  contour 
levels,  and  all  grid  points  indicated. 


Finally,  plots  (but  not  output)  are  generated  in  a  machine 

independent  fashion  on  file  2.,  and  a  post-processor  (usually 

PLOTREAD)  is  used  to  interface  to  the  local  graphics  package. 

Depending  upon  installation  and  requirements,  the  user  might  want  file 

2  to  be  a  permanent  file. 

6.51  STEP  BY  STEP  INSTRUCTIONS  FOR  SHONTL 

Step  1:  Two  data  files  are  needed  by  SHONTL.  They  are  file  11, 

and  these  files  must  be  named  11  and  19.  The  best  way  to 
do  this  on  the  UNIVAC  is  to  use  the  @USE  command. 

Step  2:  Enter @XQT  P0LAR*SH0ABS. SHONTL. 

Step  3:  Now  you  need  to  enter  the  information  needed  to  retrieve 

the  slice  you  wish  to  plot.  The  instructions  for  the 
input  routine  are  in  the  form  of  keywords  (6.52). 
Additionally,  there  are  several  commands  to  help  use  the 
keywords  to  get  the  desired  plots  (6.52). 

The  first  step  is  to  choose  the  plotting  features  you  wish 
to  use.  These  include  marking  the  grid  boundaries, 
showing  the  silhouette  of  the  object,  marking  the  grid 
points,  choosing  the  axis  for  the  problem  and  choosing  a 
title  for  the  plot.  (There  is  a  complete  list  of  the 
keywords  in  the  next  section.) 

Step  4:  When  all  of  the  desired  features  have  been  chosen,  a  slice 

needs  to  be  defined.  At  this  point  a  plot  is  generated. 
There  are  several  useful  defaults  which  produce  sets  of 
plots  (see  6 . 53 )’\  Now  one  can  return  to  step  4  to  produce 
additional  graphs  or  continue  onto  step  5. 

Step  5:  To  leave  SHONTL,  type  EXIT  if  you  want  hard  copies  of  the 

plots  to  be  generated.  Type  ESC  (for  escape)  if  no  hard 
copies  are  desired.  The  EXIT  command  will  call  PLOTRD 
automatical ly. 

Step  6:  Show  all  of  your  friends  your  nifty  plots. 


6.52  SHONTL  KEYWORDS 


The  following  is  the  current  list  of  SHONTL  keywords.  All  of 
the  input  which  cannot  be  recognized  is  simply  printed  on  the  screen 
and  then  ignored. 

The  form  of  a  keyword  definition  is 

KEYW0RD[,  equivalent  forms](*def ault  setting*/other  settings) 

def inition 

The  terms  "ON"  and  "OFF"  describe  the  setting  of  the  option.  So  if 
something  is  set  to  "OFF",  it  will  not  appear  on  the  plot.  For 
example, 

PLOTS  OFF 

will  cause  those  plots  generated  while  the  flag  is  off,  to  not  be 
printed.  Since  default  value  of  PLOTS  is  off,  to  prevent  undesired 
plots,  the  definition  of  PLOTS  looks  like 

PLOTS  (*0FF*,0N)  causes  the  . 

Here  is  the  present  keyword  list: 

ALL  (ON/OFF)  turns  all  of  the  on/off  switches  to  ON  or  OFF. 

"ALL  ON"  would  turn  on  all  of  the  keywords  which  can  be  set  to 
(ON/OFF). 

AXDRAW  (*0N*/0FF)  controls  the  printing  of  the  plot  axis,  scale 
values,  and  axis  labels. 

A2SURF  (*0N*/0FF)  controls  the  printing  of  the  object's 
silhouette. 

COLOR  (0N/*0FF*)  turns  on  color  filled  features.  This  may 
depend  on  the  use  of  a  Jupiter. 

COMMENT  causes  the  input  routine  to  ignore  the  rest  of  the 
line.  Note  that  only  the  first  six  characters  on  the  line  are 
actually  read. 


CONLIN  (*ON*/OFF)  controls  the  printing  of  the  contour  lines  on 
the  plot. 

DEBYE  causes  the  scale  on  the  plot  to  be  in  Debye  lengths.  The 
origin  (0,0)  is  the  object  grid  origin  (see  'GRID').  The  normal 
default  is  to  grid  units. 

DENSIT, DEN, 0.  This  is  a  request  for  a  plot  of  a  slice  of 
density  data.  The  allowable  forms  of  requests  for  density 
slices  are 

DENSIT  X  N 
DENSIT  X  MIDDLE 
DENSIT  X 
DENSIT 

where  either  of  the  abbreviations  may  be  substituted  for 
DENSIT.  /Iso  Y  or  Z  can  be  used  for  X,  MID  can  be  used  for 

middle,  and  N  is  a  positive  integer  on  the  axis  (X,  Y,  or  Z) 

that  is  in  the  grid  space.  The  axis  is  the  axis  perpendicular 
to  the  plane  of  the  slice.  If  form  2  or  3  are  used,  the  middle 
of  the  object  grid  will  be  plotted.  If  the  last  form  is  used, 
the  middle  X  and  Y  slices  will  be  plotted. 

ERASE  causes  any  plots  which  have  been  created  to  be  erased  and 
not  produced  by  PLOTRD. 

ESC  causes  the  SHONTL  module  to  be  exited  immediately  without 
any  additional  output.  (The  keyword  ESCAPE  is  equivalent.) 

EXIT  signals  the  end  of  the  input.  If  no  plots  have  been 

requested  at  this  point  and  'PLOTS'  is  'ON',  then  four  plots 

will  automatically  be  produced.  They  will  be  plots  of  the 
potential  and  density  at  the  middle  of  the  X  and  Y  axes. 

FILLIN  (*0FF*/0N)  causes  the  interior  of  the  object  to  be 
filled.  The  routine  looks  for  zeros  surrounded  by  relatively 
big  numbers.  This  changes  the  appearance  of  the  contour  lines 
in  a  way  which  may  be  desirable.  (Obsolete.) 

FRAME  (*PLASma*/CRAFt)  -  (**/X  Y  Z).  This  keyword  chooses  the 
reference  frame  for  viewing  potentials.  The  default  is  the 
plasma  frame  used  by  NTERAK,  but  a  spacecraft  frame  may  be 
chosen  where  the  vxB  electric  field  will  appear  at  'infinity'. 

In  the  spacecraft  frame  the  definition  of  plasma  ground  will 
appear  arbitrary  (it  is  not  really)  but  it  may  be  shifted  from 
the  point  chosen  by  NTERAK. 

GETSLC  (*0N*/0FF)  causes  the  plot  generation  routine  to  read  a 
slice  from  the  data  file. 

GRDPTS  (0N/*0FF*)  causes  crosses  to  be  printed  at  each  of  the 
nodes. 
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GRID  causes  the  scale  of  the  plot  axes  to  be  in  object  grid 
units.  The  reference  point  in  this  coordinate  system  is  the 
lower  left  corner  of  the  object  definition  grid  which  is  defined 
to  be  (1,1).  This  is  the  default  scaling. 

HEADNG  (*ON*/OFF)  causes  the  heading  to  be  printed  at  the  top  of 
the  plot. 

IDIAGS(N)  is  the  keyword  input  section  which  allows  setting  of 
any  of  the  IDIAGS  flags.  For  information  concerning  the  IDIAGS, 
see  Section  6.70. 

INPSPT  (*0*) .  The  keyword,  INPSPT  (INPUT  SPOT),  is  used  to 
trace  the  trajectory  of  a  number  of  particles  (SPOTS)  which  the 
format  for  keyword  is  "INPSPT  N",  where  N  is  the  number  of 
points  to  be  entered.  The  maximum  number  of  points  is  20. 

After  the  INPSPT  keyword,  the  N  particles  are  defined  by  giving 
their  initial  position  (X,Y,Z)  and  velocity  (VX,VY,VZ).  For 
example,  if  we  wanted  to  define  two  particles,  one  with  the 
position  (4. ,5. ,6.)  in  grid  units  and  velocity  (— .1,— .1 ,— 4. ) 
normalized  to  the  ion  acoustic  speed  (see  documentation,  POLAR 
Manual,  Section  5.62.12),  and  a  second  particle  with  the 
position  (-l.,3.,-2.5)  and  a  velocity  of  (-1. ,-.3, .01)  we  would 
enter: 


INPSPT  2 
4.  5.  6. 

-.1  -.3  ■ 


-.1  -.2 

2.5  -1. 


•  V 

•  ,  *  « 


W 

"A 


JDIAGS(N) .  See  entry  for  IDIAGS(N). 

KDIAGS(N).  See  entry  for  IDIAGS(N). 

LEVELS  (*10*-AUT0)  set  the  number  of  contour  lines  to  be  drawn 
and  their  selection  mode.  The  keyword  LEVELS  is  also  an  entry 
word  to  the  following  contour  options: 

LEVELS  AUTO  linearly  spaced  contours,  rounded  to  nice 

numbers,  for  potentials,  the  kT  and  0.1*kT 
contour  will  be  added  and  the  kT  level 
marked. 

LEVELS  NOMARK  turns  off  all  contour  marking. 

LEVELS  MARK  VALUE  MARKER  will  mark  the  contour  level  at  VALUE 

with  the  first  character  of  MARKER. 
Marking  with  a  number  can  be 
accomplished  by  #LLL  where  #  is  a 
number  and  L  is  any  letter.  Only  # 
will  be  used,  but  the  LLL  is 
necessary  for  #  to  be  recognized  as 
a  literal.  This  command  may  be 
repeated  to  mark  up  to  nine  levels. 


«\>V 


•w 

S;* 


r.  ■ 

>s?: 


.  /-.-Vv 


VV 
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LEVELS  ADD  VALUE,  add  a  contour  level 

LEVELS  SUB  VALUE,  remove  a  contour  level 

LEVELS  SELECT  VALUE,  turn  off  auto  mode  and  use  input  levels 

LINEAR  means  the  contour  lines  will  be  of  the  unmanipulated  data 
in  the  slice.  This  is  the  default  mode. 

LOG  causes  the  contours  to  be  of  the  natural  log  of  the  slice 
data.  The  normal  default  is  'LINEAR'. 

L0G10  causes  the  contours  to  be  of  the  base  10  log  of  the  slice 
data.  The  normal  default  is  'LINEAR'. 

METERS  causes  the  units  of  the  scale  of  the  plot  axis  to  be  in 
meters.  The  origin  (0,0)  is  the  object  grid  origin  (see 
'GRID').  The  units  default  to  grid  units. 

MIDDLE, MID.  These  keywords  must  follow  X,  Y,  or  Z  to  be 
meaningful.  In  this  context,  they  cause  the  plot  to  be  of  the 
middle  of  the  object  grid.  (For  a  more  exact  description  of  the 
middle  of  the  grid,  see  'DENSITY'.) 

NONE.  This  keyword  can  be  substituted  for  POTENT  or  DENSIT.  It 
will  cause  plots  to  be  made  without  potentials  or  ion 
densities.  It  can  be  used  to  look  at  the  output  from  VEHICL. 
When  plots  of  sheaths  and  trajectories  are  made,  it  is  also 
helpful.  The  syntax  for  NONE  is  exactly  the  same  as  for  POTENT 
or  DENSIT. 

NUMBER  (0N/*0FF*).  NUMBER  is  used  when  tracing  particles.  If 
it  is  used  in  conjunction  with  IDIAG(6)=5,  the  particle  pusher 
will  number  the  particles  for  diagnostic  output.  This  is  very 
useful  for  debugging  the  CURREN  segment.  (See  also  the  notes  on 
I D I AGS . ) 

OBJCNR  (0N/*0FF*)  causes  four  small  boxes  to  be  drawn  in  the 
corners  of  the  object  grid. 

OBJGRD  (ON/*OFF*)  causes  the  object  grid  to  be  plotted. 

OUTREL  (*0N*/0FF)  causes  the  outer  stepped  grid  of  real  nodes  to 
be  plotted. 

OUTVIR  (*0N*/0FF)  causes  the  outer  stepped  grid  of  virtual  nodes 
to  be  plotted. 

PERSPC  (0N/*0FF*).  When  PERSPC  is  on,  all  of  the  sheath  points 
and  trajectory  paths  will  be  plotted.  If  it  is  off,  then  only 
those  points  or  paths  which  are  in  or  cross  the  slice  being 
drawn  wi 11  be  shown. 
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PLOTS  (ON/*OFF*)  causes  the  plots  to  be  produced.  If  it  is  off, 
the  slices  will  be  read  and  processed  for  plotting,  but  will  not 
be  plotted. 

PLTGRD  causes  the  scale  of  the  axis  to  be  in  plotting  grid 
units.  These  are  the  same  size  as  object  grid  units  but  the 
lower  left  corner  is  defined  to  (0,0).  In  object  grid  units, 
the  reference  point  on  the  grid  is  the  lower  left  corner  of  the 
object  definition  grid  which  is  defined  to  be  (1,1).  The 
default  is  object  grid  units. 

POTENT, POT, P.  This  is  the  same  as  ' DENSIT '  except  potential 
slices  instead  of  density  slices  will  be  plotted.  Please  see 
'DENSIT*  for  more  information. 

PRINT  name  causes  name  to  be  read  from  the  appropriate  file. 
Valid  name  replacements  are  any  of  the  buffered  data  lists 
mentioned  in  Section  5.33.  For  larger  data  sets,  the  use  of 
SELECT  is  recommended  (see  below). 

PRTSLC  (*0FF*/0N)  causes  a  grid  of  integers  to  be  printed.  This 
is  helpful  to  examine  a  slice  for  plotting  before  a  plot  is 
actually  produced.  Be  sure  to  turn  'PLOTS  OFF'  if  plots  are  not 
desired. 

RESET.  This  keyword  resets  all  of  the  plotting  flags  to  their 
initial  values. 

RING  (0N/*0FF*) .  Sometimes  on  large  problems,  it  is  desirable 
to  trace  fewer  particles.  One  way  to  do  this  is  just  follow  a 
ring  of  particles.  Presently  the  only  rings  in  the  XY  plane  can 
be  made.  N  is  the  Z  slice  of  the  ring.  If  a  ring  in  the  Z=22 
slice  was  desired,  the  keyword  would  be  "RING  22".  If  RING  is 
followed  by  ON  or  nothing  at  all,  the  middle  Z  slice  will  be 
used. 

SELECT  options  used  to  choose  particular  Z-slices  for  printing 
when  using  PRINT  or  a  DIAG  (or  IDIAGS,  etc.)  flag.  Many  options 
are  available  and  the  user  is  referred  to  Section  6.44,  6.45  or 
6.70. 

SHEATH  (0N/*0FF*)  causes  the  sheath  points  to  be  printed  on  the 
plot. 

SPOTS  (0N/*0FF*).  To  push  a  few  test  particles  to  see  which 
trajectories  they  will  take,  use  the  SPOTS  flag.  To  enter  these 
particles,  see  INPSPT.  It  is  recommended  that  PERSPC  is  ON  when 
SPOTS  is  used. 

STHPOT  N.  The  SHEATH  potential  for  plotting  the  sheath  can  be 
changed  by  resetting  STHPOT.  The  initial  value  is  the  same  as 
the  value  used  by  CURREN  during  NTERAK.  N  is  a  real  number. 
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TITLE.  Used  to  define  the  title  to  be  put  on  the  plot.  The 
default  is  "POLAR  PLOTS".  The  desired  plot  title  should  start 
in  the  ninth  column  of  the  card 
1234567890123456 
TITLE  BIG  BIRO 

In  the  above  example,  the  heading  appearing  on  the  plot  would  be 
"BIG  BIRD".  Currently  there  is  a  16  character  maximum. 
(Presently  unimplemented.) 

TRAJ  (0N/*0FF*).  This  flag  turns  on  plotting  of  particle 
trajectories. 

WEED  ( *0N*/ OFF ) .  This  flag  reduces  the  number  of  particles 
usually  found  by  CURREN  by  about  a  factor  of  4.  This  not  only 
speeds  up  the  plotting  process  but  also  makes  the  plots  a  little 
clearer. 

WHAT  causes  all  of  the  print  options  and  their  current  settings 
to  be  printed  at  the  terminal. 

X,Y,Z  the  axis  perpendicular  to  the  slice  to  be  plotted.  If 
both  potential  and  density  plots  are  desirable,  something  like 
X  8 

can  be  typed.  This  plots  the  X  =  8  slice  of  the  density  and  the 
potential  data.  Instead  of  8,  any  integer  containing  part  of 
grid,  middle  or  mid,  or  nothing  at  all  can  be  used.  Nothing  at 
all  will  default  to  a  middle  slice.  Valid  forms  are 
X  N 

Y  MIDDLE 
Z  MID 
X 

where  X,  Y,  and  Z  are  interchangeable  and  N  is  any  integer  as 
described  above.  Please  see  ' DENSIT '  for  more  information. 


6.53  SPECTRUM  KEYWORDS  AND  OPERATING  INSTRUCTIONS 
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The  spectrum  plots  are  generated  by  SHONTL  using  the  plasma 
characteristics  used  by  a  previous  NTERAK  run  or  by  defining  the 
environment  using  the  same  keywords  used  in  NTERAK. 

SHONTL  keywords: 

(Note  that  the  range  of  values  plotted  on  the  vertical  axis  is 
currently  not  controllable  by  the  user  and  is  limited  to  six 
orders  of  magnitude  down  from  the  maximum  flux  while  in  the 
LGLINY  LOG  mode.) 

Default  options  are  marked  by  surrounding  *'s.  These  *’s  are 
not  part  of  the  keyword. 

6.54  SHONTL  DEFAULTS 

SHONTL  has  lots  of  defaults.  All  of  the  plot  features  have 
defaults  (6.52).  There  are  also  slice  default  values  for  which  slices 
are  printed.  The  current  slice  defaults  are  also  in  Section  6.52 
under  the  'DENSIT'  definition. 

The  default  values  will  vary  as  the  plotting  requirements 
change.  The  best  place  to  look  for  default  changes  will  probably  be 
the  code  itself.  The  WHAT  command  gives  the  feature  defaults. 


KEYWORDS 


HIGHEN  n  n  is  the  value  of  the  energy  cutoff  on  the 

high  end. 

INKEV  NO  y  axis  always  in  eV,  x  axis  is  variable. 

*YES* 

LGLINY  log  a  log  10  or  linear  plot  of  data  on  the  vertical 

*lin*  axis. 

LGLINX  log  a  log  10  or  linear  plot  of  data  on  the  horizontal 
*lin*  axis. 

NPTS  n  number  of  points  to  be  calculated  and  connected 

(0  <  n  <  200). 

RLOWEN  n  n  is  the  value  of  the  low  energy  cutoff  on  the 

horizontal  axis. 

SPECTRUM  draw  a  spectrum  plot  using  the  previously  entered 

information. 

WRITE  write  the  plasma  environment  generated  so  far 

during  the  current  run  onto  files  11  and  19. 


